
来源:github · 原文链接:https://github.com/arjun988/blender-skills · 整理:github_bot · 发布时间:2026-11-16
一、项目概览
blender-skills 把「Blender 建模」这件事拆成了 94 个可以被 AI 编程助手直接调用的专项技能。它并没有做成一个独立的 Blender 插件,也没有做自己的对话界面,而是把技能包挂到 Cursor、Claude Code、Kiro、Codex 这四个 AI 客户端的技能目录下,再通过 BlenderMCP 插件,把每个技能的执行动作真正交给运行中的 Blender 去完成。换句话说:AI 负责判断「该做什么、按什么顺序做」,BlenderMCP 负责「真的动手」。
从定位上看,它解决的是 AI 辅助 3D 制作里一个很实际的断裂:大模型能写几何节点、能教你怎么布线,但它不能替你建出模型。把 MCP 当作执行通道之后,技能从「说明书」变成了「可执行流程」。README 里的示例已经很直白——说一句「给 Unreal Engine 做一把游戏就绪的科幻步枪,3k 面,写实 PBR」,技能链是 hard-surface → uv-workflow → materials → asset-optimization → export-pipeline,全程不涉及手工 UI 走查。
仓库以 MIT 许可开放,当前需要从 GitHub 直接克隆安装(Claude 插件市场仍在审核中);主仓库语言标为 TypeScript,主要对应 site/ 下的文档站与 Next.js 配置,核心资产其实是 .claude/skills/ 下那 94 个技能目录与 175+ 个 reference 文件。约 3.7k star、339 fork 的数据说明,这个「技能即管线」的思路在 3D 与游戏开发社区里踩中了真实需求。
二、核心特性速览
| 特性 | 说明 |
|---|---|
| 技能规模 | 94 个专项技能,覆盖建模、生产、技术、管线、风格、世界、品类 |
| 编排入口 | blender-director 分析请求意图,自动路由到合适的技能链 |
| 执行方式 | 全部通过 BlenderMCP 在 Blender 内执行,不做 UI 步骤讲解 |
| 参考图匹配 | 参考分析 → 相机对齐 → 几何分层 → 材质灯光 → 截图比对循环 |
| 生产标准 | 内置命名规范、面数预算、游戏就绪输出约定 |
| 质量门禁 | 导出前必须经过 asset-optimization 与 checklist 校验 |
| 跨客户端 | 同一份技能包同时适配 Cursor / Claude Code / Kiro / Codex |
| 导出目标 | Unreal、Unity、Godot 三条独立导出技能 |
这里最值得注意的不是「94」这个数字,而是编排层与执行层的分离。大多同类项目要么是一堆 prompt 模板(可读不可跑),要么是一个大而全的单一 agent(只能靠一个超长提示词硬撑)。blender-skills 选了中间路线:技能是模块化的、可组合的、有明确上下游的,而组合逻辑交给一个专门的 director 技能。这让「加一个技能」变成低风险操作——不会牵动整条链。
三、系统架构设计

从架构图的分区看,整个系统被切成三层,节点之间的连线基本就是把一次请求的完整生命周期摊平。
交互与接口层由 entry(AI 客户端)与 api(MCP 接口)组成。AI 客户端是 Cursor、Claude Code 这类工具,tag 为 UI,它承担的是「用户意图入口」;MCP 接口由 BlenderMCP 插件承载,负责协议握手与工具暴露。这一层的设计取舍很明确:不重造客户端,寄生在已有生态里。好处是用户的学习成本几乎为零——你已经会用 Cursor,就只差把技能目录拷过去、把 MCP 连上。代价是必须跟着四家客户端的技能目录规范和 MCP 配置格式走,任何一个上游变更都会传导过来。
核心编排层是 side1(技能编排 / blender-director,tag ROUTE)与 core(执行引擎 / MCP Tools,tag EXEC)。请求从 entry 下发到 core,同时 api 完成协议接入;director 拿到意图后做技能路由,core 再把动作翻译成具体的 MCP 工具调用。这里的分工是整套设计的重心:director 决定顺序与组合,core 只负责执行动作。质量校验 guard(QA Checklist)作为旁路挂在 core 上,形成质量门禁——也就是说校验不是最后才想起来的一步,而是主链上的一个节点,需要时可以被反复触发。core_to_side2 这条「调用 Blender」连接指向真正的 3D 软件,说明执行引擎本身不持有状态,状态在 Blender 里。
能力与外部层横向铺开四个节点:tools(技能库 / 94 Skills,tag SKILL)、data(参考知识 / references,tag REF)、exec(引擎导出 / UE·Unity·Godot)、side2(Blender 端)。技能库是能力池,tools_to_data 表示技能运行时会去读 references 里的命名规范、面数预算、MCP 工具清单、验收清单;guard_to_tools 表示质量门禁会反向调用校验类技能;tools_to_exec 则是链路终点——资产从技能库流到导出技能,落进目标引擎。
一句话概括这套架构的性质:它是一个把「知识」和「动作」分层、把「组合」和「执行」分权的系统。知识放在 references 里可读可改,动作交给 MCP 工具,组合交给 director。三者解耦,是这个项目能扩展到 94 个技能而不失控的结构性原因。
四、核心流程或主循环

生产主循环有六个站点,绕着一个「生产管线中枢」转,回写路径保证每一步的结果都能被后续步骤看到。
第一步,需求解析(意图识别)。 用户的自然语言请求进来后,先做的是意图与约束的提取:这是硬表面道具还是环境 kit?目标引擎是什么?面数预算多少?风格取向是什么?这一步的产出不是模型,而是一份可执行的约束集。很多 AI 建模尝试失败在这里——把「做一把帅气的枪」直接当成建模指令,结果必然发散。
第二步,技能路由(director)。 上一步的约束集被映射成技能序列。README 里给的三条样例很能说明问题:硬表面武器走 hard-surface → uv-workflow → materials → asset-optimization → export-pipeline;恐怖走廊走 horror-style → environment-artist → lighting → export-pipeline;生物重拓扑走 retopology → uv-workflow → texture-workflow → rigging。同一个 director,三种完全不同的链。
第三步,MCP 执行(MCP Tools)。 循环的焦点站点。每条技能的具体动作在这一步通过 MCP 工具在 Blender 里发生——建几何、分配材质、生成 UV、设灯光。关键约束是「不叙述 UI 步骤」:技能不允许输出「请在修改器面板点击添加」这类内容,必须真的调用工具。这条规则看起来很细,实际上决定了整个项目有没有价值——只要允许叙述,模型就会退回成教程生成器。
第四步,参考比对(截图对比)。 如果请求带参考图,循环在这里进入内环:参考分析 → 相机对齐 → 几何分层 → 材质 → 灯光 → 截图对比,然后回到前面重新调整。这是一个闭环迭代器,不是线性步骤。focal 在第三步、迭代在第四步,说明「先动手、再对齐」而不是「先对齐、再动手」——对生成式流程来说,先有一个可比的粗糙结果,比先做完美规划更快收敛。
第五步,优化校验(Checklist)。 面数、命名、UV 排布、LOD、碰撞代理等被逐项核对。这一站是导出前的唯一闸门,也是「作品」与「资产」的分界线。
第六步,引擎导出(UE/Unity)。 通过独立导出技能落到目标引擎,包含坐标系、缩放、材质转换等引擎侧约定。
整个循环通过两条回写路径闭环:状态回写(当前进度、已建对象)与结果回写(比对差异、校验结论)。这让「重来一次」不需要从头开始。
五、核心模块解析
| 模块 | 职责 |
|---|---|
| Orchestration | blender-director 作为统一入口,解析请求并路由到下游技能链 |
| Modeling | 通用建模、硬表面、道具、载具、环境、植被、角色、生物、角色原型 |
| Production | 雕刻、重拓扑、UV、材质、纹理、毛发、布料解算、LookDev |
| Technical | 几何节点、灯光、相机与运镜、渲染、合成、动画、绑定、VFX、物理 |
| Pipeline | 程序化建模、场景装配、布景、资产优化、LOD、碰撞代理、导出、QA、ArchViz |
| Styles | 恐怖、PSX 恐怖、低多边形、动漫、体素、等距、风格化、写实,另有 15 种扩展风格 |
| Worlds & Genres | 世界/情绪包与品类方向包,用于给资产定调与对齐玩法语境 |
这张表里最值得关注的是 Pipeline 模块的存在。绝大多数 AI 建模尝试止步于「看起来对」,而这个项目把 asset-optimization、lod-pipeline、collision-proxy、qa-review 都做成了独立技能——这恰好是「能进引擎」和「只能截图」的分水岭。技术模块里的 geometry-nodes 和 rigging 也说明它不只想做静态展示,而是想覆盖动画就绪的资产。
另一个观察是风格与品类的颗粒度。恐怖被拆成 horror-style / psx-horror-style,再往下还有 cosmic-eldritch、body-horror、analog-found-footage、liminal-space、folk-horror、mascot-puppet、dream-weirdcore、indie-horror-aesthetics 八个子类型包。这种拆法在传统资产库里很少见,但在 AI 技能体系里是合理的:风格描述越具体,模型跑偏的概率越低。品类包(shooter / soulslike / racing-sports / open-world-sandbox 等)同理,它们不产生几何,而是产生约束。
六、特色能力
风格与氛围是这套技能包辨识度最高的部分。核心风格 8 种(恐怖、PSX 恐怖、低多边形、动漫、体素、等距、风格化、写实),扩展风格 15 种(卡通、美漫、漫画、像素、手绘、绘画感、定格动画、Q 版、黑色电影、极简、矢量、8bit、16bit、高清 2D、Frutiger Aero)。这个排列本身有信息量:它把「美术风格」当成可枚举、可选择的参数,而不是靠模型自由发挥。
世界与情绪包(奇幻、科幻朋克、历史、末世、生物群系、治愈、暗黑、梦核、霓虹复古未来、粗野主义)和品类方向包(动作、射击、RPG、生存、潜行、解谜平台、银河城/肉鸽、类魂、策略模拟、竞速、叙事 VN、卡牌/派对/放置、开放世界)解决的是另一类问题:同一个模型,放进不同的世界和玩法语境里,比例、材质语言、细节密度都该不同。这类包不直接建几何,但会影响每一次几何决策。
参考图匹配是技术含量最高的单项能力。它不是简单的「看图说话」,而是一条带相机反解的流水线:先分析参考的构图与焦距,把 Blender 相机对上去,再分层推进几何,最后用截图与原图做循环对比。对概念美术转模、复刻现有资产这类工作,这条链的价值远大于任何单个建模技能。
七、工具链或生态
安装路径非常轻:
# 1) 克隆技能包
git clone https://github.com/arjun988/blender-skills.git
# 2) Claude Code:把技能拷进项目
cp -r blender-skills/.claude/skills /path/to/your/project/.claude/skills/
# 3) Cursor(Windows PowerShell)
Copy-Item -Recurse -Force "blender-skills\.claude\skills\*" ".cursor\skills\"
# 4) 之后再配好 BlenderMCP(uv + 插件 + Connect)
四步 MCP 配置是固定套路:装 uv、在 Blender 里装 BlenderMCP 插件、侧边栏 N 面板点 Connect to Claude、重启 AI 客户端(Cursor 读 .cursor/mcp.json,Claude Code 读 .mcp.json)。仓库结构里 .cursor/skills/ 是 .claude/skills/ 的同步镜像,说明多客户端适配走的是「一份源、多份镜像」而不是抽象适配层——简单、可预测,但镜像可能漂移。
导出侧覆盖 Unreal、Unity、Godot 三家,每条都有独立技能而非一个泛化的「导出」技能,符合引擎间坐标系、缩放、材质系统的实际差异。
八、部署与安全
部署模式是纯本地的:GitHub 克隆 → 复制目录 → 本地 MCP 连接运转中的 Blender。没有云端执行环节,模型只负责编排,真正的几何操作发生在你自己的机器上,资产不离开本地,这对商业项目是硬性要求。
依赖面很窄:uv 运行时 + BlenderMCP 插件 + 一个支持 skills 的 AI 客户端。风险点也在同样的地方——BlenderMCP 是第三方插件,MCP 工具调用意味着模型对本地 Blender 有实际写权限。技能包本身是 Markdown 文本(可审计、可 diff、可自定义),但「可执行」的前提就是你愿意给模型这份权限。MIT 许可让代码与技能内容都处于可审查状态,这对担心供应链的团队是加分项。
九、适用场景
最直接的三类:游戏硬表面资产(武器、道具、载具,有明确面数预算与引擎目标)、模块化环境 kit(走廊、房间、布景,需要几何节点与 UV 一致性)、角色与生物管线(雕刻 → 重拓扑 → UV → 纹理 → 绑定,为动画做准备)。
第二类是参考驱动的复刻与原型:手上有一张概念图或实物照,想快速得到可比的 3D 版本,走 reference-image-match 那条链,比从零手搓快得多。第三类是风格探索:同一份资产描述,换成 horror-style 或 anime-style,看几何与材质语言如何变化,用作品质的早期判断。
不太适合的场景也要说清楚:影视级高模雕刻、需要主观艺术判断的原创造型、以及对确定性要求极高的批量生产——这些地方 AI 编排带来的收益不足以覆盖调试成本。
十、总结评价
这个项目真正的价值不在「94 个技能」这个数字上,而在于它把 AI 辅助 3D 制作从「对话」推进到了「管线」。三层架构里最关键的一刀是把知识(references)、动作(MCP tools)、组合(director)三者拆开——知识可读可改,动作真实执行,组合逻辑集中在一处。正因为拆得干净,它才能从几个技能长到九十几而结构不散。第二个价值点是 Pipeline 模块的存在:asset-optimization、lod-pipeline、qa-review 这些「不酷但必需」的环节被做成了头等公民,说明作者清楚「能进引擎」才是终点。
适用人群很明确:已经在用 Cursor / Claude Code 做开发、同时做 3D 资产的独立开发者与小团队——尤其是做恐怖、PSX、低多边形这类风格化项目的,风格包的颗粒度对你几乎是为量身定做。纯粹的美术从业者收益有限,因为这条链的价值在于「把重复的工程环节自动化」,而不是「替你做审美判断」。
局限同样清楚。第一,强依赖 BlenderMCP 这个第三方插件,它一改,全链路受影响;第二,模型走偏时的调试成本不低——你得判断是技能选错了、还是执行参数错了、还是 Blender 里状态脏了;第三,94 个技能带来的选择过载实打实存在,director 的路由质量直接决定体验上限;第四,.cursor/skills 与 .claude/skills 双份镜像的维护方式,长期看会积累不一致。
一句话:它不是「AI 帮你建模」,而是「AI 帮你跑完一条你原本要手动跑的管线」。把它当成流程自动化的工具用,回报最稳;指望它替代美术判断,则会失望。
参考链接: