最近圈子里聊得最多的一个玩法就是给Claude Code、WorkBuddy、Codex这些AI编程智能体装上“技能包”让它们从只会写代码的通用助手变成某个垂直领域的老手。我自己折腾了一个多月把这三个工具组合起来搭了一套3D设计IP潮玩工作台还实际跑通了“牛来”和“游泳男孩女孩”两个潮玩IP案例。这篇文章就把整套思路、Skill的写法、踩过的坑一次性讲清楚想复现的直接按步骤抄作业就行。适用的人很明确懂一点AI工具、想用自然语言驱动3D设计、又不满足于只让AI“聊天”的玩家。不管你是做潮玩工作室、产品设计还是纯粹想给自己捏一个虚拟形象这套方案都能帮你把设计流程沉淀成可复用的自动化能力。我自己不是专业3D建模师出身是靠这套工作台把想法变成可打印模型的所以这篇分享会更侧重“怎么让AI替你干活”而不是教你手把手雕刻。1. 核心思路拆解为什么是这三个工具组队1.1 Claude Code、Codex、WorkBuddy各自该干什么先把角色理清楚。这三样东西都不是为3D设计而生的但组合起来刚好覆盖一条完整链路Claude Code负责“想”Codex负责“算”WorkBuddy负责“管”。Claude Code的优势在长上下文理解和多轮推敲。它的对话记忆能力强适合把一个模糊的设计需求反复打磨成具体规格。比如你说“我要一个憨厚的小牛”它能追问你风格偏写实还是卡通、角度是正面还是微侧、要不要底座刻字最终输出一份结构化的设计方案。Codex的强项是命令执行和批量脚本生成适合把设计方案转成实际的建模脚本、调整参数、批量生成变体。WorkBuddy则是那层壳把前两者的会话、Skill、文件输出都收在一个可视化的界面里方便你同时开多个任务比如一边让Claude Code细化牛头的表情一边让Codex算模型壁厚是否满足打印要求。一句话总结分工Claude Code是设计总监Codex是建模师傅WorkBuddy是项目管理看板。1.2 为什么不用专业3D软件而是用AI智能体可能有人会问直接用Blender或者ZBrush不就完了吗折腾这三件套图什么我的答案很直接可复用性和批量生产能力。传统建模工具的高度依赖手工操作你花三天捏出一个模型下一个新IP又要从头再来。但用智能体加Skill的方案把建模流程拆成“结构化的指令脚本参数”只要沉淀出一个Skill后面换角色、换表情、换尺寸就是改几个参数的活。我做“游泳男孩”从确定需求到输出第一版可打印模型只花了一个晚上这在手工建模时代是不可想象的。另外这套工作台生成的中间产物全是脚本和文本天然可以版本管理、回溯和分享团队协作时效率高很多。2. 先把3D潮玩设计这件事拆成AI能理解的流程2.1 工作台的整体链路设计要让AI真正干设计活不能把整个流程一股脑丢给它。我根据3D打印潮玩的实际流程把工作拆成六个阶段需求澄清、角色设定、建模参数生成、模型细化、打印文件预处理、切片与打印。需求澄清阶段由Claude Code主导通过结构化提问把模糊的想法变成明确的参数比如角色物种、风格倾向、目标尺寸、是否需要可动部件。角色设定阶段输出一份角色设定文档包含外观描述、色彩方案、性格关键词这相当于给建模提供文字蓝图。建模参数生成阶段是最关键的一步我会利用Codex生成一个参数化建模脚本也就是用代码描述几何体而不是直接操作网格。模型细化阶段涉及雕刻细节、表情、配饰。打印文件预处理阶段要检查网格是否为封闭实体、壁厚是否足够、有没有悬垂结构。切片与打印阶段则由外部切片软件接管。2.2 参数化建模让代码生成模型的关键很多第一次接触这套方案的人会卡在“AI怎么生成模型”这个问题上。我用的主要方案是OpenSCAD加CadQuery这类程序化建模工具。OpenSCAD本身用脚本语言描述几何体整个模型就是一段代码非常适合AI生成和参数调整。CadQuery则更贴近制造业的CAD思维处理倒角、布尔运算、抽壳等操作特别干净。实际工作流是这样的Claude Code把设计需求整理成参数列表比如头部直径、身体高度、耳朵角度、眼睛位置然后交给Codex生成OpenSCAD代码。生成之后我会用OpenSCAD预览渲染如果哪里不对就从代码层面修改参数。这种方式的优势是模型不是一团不可控的网格而是完全可计算、可微调、可复用的生产线今天能生成一头牛明天把参数换成鸭子和熊就能生成另一个IP。3. 核心实操从零搭建Craftsman Agent工作台3.1 环境准备Claude Code与Codex的安装配置安装这一步不难但有几个细节值得注意。先装Claude Code它基于Node.js需要先保证本机有Node.js环境。确认Node版本没问题后执行安装命令npm install -g anthropic-ai/claude-code安装完成后建议先跑一下版本检查确认不是装成了旧版claude --versionCodex的安装类似也是通过npm安装npm install -g openai/codexCodex默认需要OpenAI的API访问权限这里需要提前在环境变量里配置好平台的API Key。如果你用的是其他兼容接口注意在配置文件里把接口地址改成自己实际可用的服务地址并且确保本地网络可以正常访问该接口不然会出现“接口请求失败”之类的报错。WorkBuddy的安装相对独立它提供一个Shell界面来统一管理不同的Agent。安装后可以把Claude Code和Codex加到WorkBuddy的配置里后续的所有操作都在WorkBuddy里发起。日常使用我会把WorkBuddy当作入口因为它可以同时开多个会话任务还能让我在不同的Skill之间快速切换不用频繁变更终端环境。3.2 Skill文件结构SKILL.md的写法与存放位置Skill的本质是一组指令和脚本按照规范放进一个目录里。早期我用的是Anthropic提出的Agent Skills开放规范结构大致是这样skills/ toy-designer/ SKILL.md scripts/ generate_toy.scad validate_mesh.py assets/ reference.pngSKILL.md是这个技能的“使用说明”头部用YAML格式声明技能名称和触发描述后面用Markdown写清楚适用场景、工作流程、关键参数、输出规范。默认情况下配置好Skills目录路径后智能体在会话里会自动识别可用的Skill根据任务内容决定是否调用。需要确认的是WorkBuddy和Claude Code能够读到这个SKILL.md如果目录配置错了智能体不会报错只会假装没有这个技能。3.3 我的toy-designer Skill核心内容示例这里直接放一个简化的SKILL.md样例标注了关键块的作用。实际使用中可以根据自己的需求扩展--- name: toy-designer description: 将一句话的角色创意转化为可用于3D打印的潮玩模型参数方案 --- # Toy Designer ## 适用场景 - 用户描述一个虚拟角色IP需要生成3D建模参数 - 需要批量生成同一角色的不同变体表情、尺寸、姿势 - 需要对已有建模脚本进行参数化调整 ## 输入要求 - 角色物种、性格、目标尺寸、风格倾向 - 特殊部件翅膀、角、尾巴的可选描述 - 是否需要拆分打印如头部单独打印便于上色 ## 工作流程 1. 用结构化提问澄清以上输入输出角色设定表 2. 将设定表转化为OpenSCAD/CadQuery建模脚本 3. 自动执行脚本并输出STL文件 4. 用Python脚本校验模型是否封闭、壁厚是否达标 5. 输出打印建议支撑位、层高、填充率 ## 输出规范 - 角色设定表存入design_docs/ - 建模脚本存入scripts/ - 最终STL输出到exports/ - 附一份markdown格式的打印说明这里面最重要的不是格式而是工作流步骤的设计。第4步网格校验是我经过好几次打印翻车之后才加进去的很多潮玩建模器生成的模型看起来漂亮拿给切片软件一跑就报错校验脚本能提前拦住大部分问题。3.4 牛来IP实战从一句话到可打印模型牛来这个IP是我做需求澄清的典型案例。最初的需求只有一句话“一个代表好运来的潮玩小牛要憨厚能站稳适合放在桌面上。”这句话信息量很大但也很模糊Claude Code通过Skill内置的提问模板补全了下列细节造型圆润度、颜色范围最终用了浅棕奶油白、牛角朝向、是否需要手持元素后来加了刻着“牛”字的小牌、底座直径必须大于头径的70%以保证重心稳定。得到完整角色设定表后Codex生成了一段OpenSCAD代码核心参数如下头部直径55mm身体高35mm底座直径为50mm耳朵角度设定为向外倾斜25度。第一版模型渲染出来以后牛脸太宽像河马。我没去手动改模型而是直接改参数头部直径降到48mm耳朵角度调到15度面颊弧度通过调整球体参数解决。第三版渲染图已经很有那个味了打印出来之后配合丙烯颜料上了色。整个迭代过程大概用了4轮总计不超过两小时。3.5 游泳男孩女孩IP实战动态姿态与打印拆分游泳男孩女孩这套IP比牛来要复杂难的不是外形而是动态姿态。牛来是站姿重心问题好解决。游泳姿态涉及四肢张开的角度、泳镜泳帽的位置、身体重心偏移稍有不慎打印出来就是一坨支撑材料。我的处理办法是把模型拆分成多个部分各自生成再组装头部加泳镜和泳帽、躯干、左臂前伸、右臂后划、双腿分开。Codex生成的OpenSCAD代码里每个部件都用独立模块封装方便单独调整角度和位置。游泳女孩的头发是一个难点长发会形成大面积的悬垂结构打印时支撑多到影响表面质量。我用了一个取巧的方案把头发改成贴合头部的泳帽造型只露出刘海既保留游泳场景的辨识度又大幅降低打印难度。组装环节同样交给AICodex写了一个Python脚本利用trimesh库把分开的部件按指定坐标拼成一个完整网格同时输出每个部件的单独STL。这样既方便整体查看也方便实际打印时分色分件处理。实测下来这套流程生成一版游泳男孩模型的周期比传统手工建模快了一个数量级。4. 常见问题与排查技巧实录4.1 智能体会话里Skill不生效最常遇到的问题就是Skill写了但智能体不认。先检查SKILL.md的YAML头部是否完整name和description不能为空description里建议写明触发条件比如“当用户提到潮玩、3D模型、IP设计时使用”这样智能体才容易判断什么时候该调用。再看目录配置WorkBuddy和Claude Code都要指向同一个skills根目录且目录里不能有中文路径我遇到过不少因为路径含中文导致智能体扫描失败的案例。4.2 生成的模型无法通过打印校验如果模型导入了切片软件却无法正常切片十有八九是网格不封闭或者存在内嵌的非流形结构。我的校验脚本会用trimesh读取STL检查是否是watertight水密网格再检查最小壁厚。对于潮玩这类小尺寸模型壁厚至少要保证1.2mm以上底座还要额外加厚否则运输过程中一摔就断。4.3 接入第三方接口时报连接错误Codex在切换到非官方接口或者本地模型服务时偶尔会遇到接口请求失败、连接中断之类的错误。这类问题大部分是服务地址配置错误、端口被占用、鉴权信息不匹配导致的。排查思路比较固定先确认接口地址能正常访问再确认服务端日志里有没有出现请求记录最后检查鉴权Key是不是对应服务商的Token不要混用。如果本地启用了第三方网关或者转发服务先暂时绕过它让Codex直接连上游接口排除链路故障。如果直连正常再去检查网关的配置和日志。这里提醒一句生产环境请务必用受支持的官方接口自己搭的转发服务稳定性难保证出了问题排查成本反而更高。4.4 排查问题速查表问题现象常见原因处理方法Skill在会话里一直不被调用SKILL.md描述不够具体在description里补充触发关键词智能体回答正常但项目文件没生成输出目录权限不足给技能目录加写权限或改到用户目录下OpenSCAD渲染报错语法错误或引用了不存在的模块检查代码报错行让Codex修复后再跑模型切片报警告/失败网格存在非封闭区域运行校验脚本用trimesh自动修复生成速度慢同时开的会话太多合并任务或拆分到多个Agent并行执行WorkBuddy导入Skill失败技能目录路径或格式错误核对目录结构确认SKILL.md在子目录根下4.5 几个能省时间的避坑技巧概念需求不要急着进建模环节先用Claude Code多追问两轮。模型改参数比重做快得多所以前期宁可让AI多问也不要对着一个方向做半天再推翻。所有生成脚本一定做版本管理。我用Git管理整个工作台目录每次改动留个提交记录后面调参调乱了随时能回滚。这个习惯帮我省了大量时间。3D打印的支撑设置尽量在建模阶段就规避。比如游泳女孩的长发改成泳帽造型、牛角的倾斜角度控制在45度以内都能显著减少支撑接触面积打印表面会干净很多。这些约束条件我会直接写进Skill的输出规范里让智能体每次建模都自动遵守。5. 这套工作台后续还能怎么延伸写到这里顺手再分享一个可以马上试的小扩展。这套Skill体系不仅仅能做潮玩模型设计只要把SKILL.md的工作流替换一下它就是一套通用的“Craftsman Agent模板”机制。比如我在同一个工作台里已经加了一个“包装盒排版”的Skill让AI根据模型尺寸自动生成包装盒的刀版图配合激光切割机就能做实物包装。本质上都是把一套流程拆解成结构化步骤再沉淀成智能体能复用的指令跟建模还是写代码没有本质区别。如果你手头已经有Claude Code或Codex环境建议直接用我上面的目录结构和SKILL.md样例跑一个小测试挑一个你最熟悉的角色做一遍需求澄清到打印文件输出的闭环。用一段时间之后你会发现AI智能体的上限其实不取决于模型本身而取决于你为它定义的流程、约束和知识边界这些才是真正属于你自己的技能资产。