text-to-cad Skill：把自然语言直接变成 STEP 文件的 AI 工程技能

text-to-cad Skill：把自然语言直接变成 STEP 文件的 AI 工程技能

功能与原则

text-to-cad 是一个面向 AI 编程 Agent 的技能库，核心命题只有一个：让 Agent 能够读懂、生成、导出真实的工程文件。传统 Agent 生成代码或脚本没问题，但在面对 CAD 模型、机器人描述文件、3D 打印切片这类有严格几何语义的工件时，完全束手无策——因为这类文件不是「文本」，而是有拓扑约束的几何体。text-to-cad 的解决方案是把 CAD/CAE/CAM 全链路拆成 12 个独立 Skill，每个 Skill 对应一种具体工件格式（STEP/STL/URDF/G-code 等），Agent 按任务需求按需调用，而不是一次性背一整套复杂工具链。设计原则：本地计算优先（几何内核跑在本地 Python 环境），零 API 依赖，输出即标准工业文件格式。

认可度

GitHub 截至 2026-09-07 约 14.5k Stars，9 月首周 GitHub Trending 多个榜单登榜，同期被 reporank.net 列入「7 日 rising list」头部位置。项目在 Claude Skills 生态、CocoLoop、Smithery 等多个 Skill 市场均可检索安装。社区讨论集中在 Maker/硬件创客圈和机器人工程圈，Discord 活跃，GitHub Issue 维护及时，v2.3.1 持续迭代中。

链接

GitHub：https://github.com/earthtojake/text-to-cad

原作者

earthtojake（GitHub username），专注 CAD/硬件设计与 AI Agent 交叉领域，维护 text-to-cad 系列多个仓库，项目采用 MIT 许可证。

介绍

text-to-cad 的本质是一组围绕「工程几何」封装好的 Agent Skill。传统 CAD 工作流需要人类在 SolidWorks/Fusion360 里建模、导出、再传给下游；text-to-cad 把这个链路语言化：Agent 接收自然语言描述（如「一个底部有四个 M3 螺丝孔的 L 型支架，底部板厚 3mm」），调用本地 OpenCASCADE 几何内核生成 solid model，输出 STEP 主格式文件，并可选导出 STL/3MF/GLB。

这个仓库最值得关注的是覆盖了 CAD 到 CAM 的完整链路，不只是「画图」这一步。往下走，有 G-code 切片（调用本地 PrusaSlicer/OrcaSlicer CLI）、Bambu Lab 打印机直传（LAN 接口 dry-run + 开始打印）；往上游走，有 URDF/SRDF/SDF 三个技能覆盖机器人描述文件全族（结构定义、运动规划、仿真世界）；横向还有 DXF（激光切割图纸）、step.parts（标准件库查询：螺丝/轴承/电机/连接器）、DfAM 可打印性检查。也就是说，从「脑子里有个零件想法」到「打印机出实物」，整个链路都可以由 Agent 驱动，不需要人类来回切换软件。

特别值得强调的是 CAD Viewer 技能：生成 STEP 文件后自动打开浏览器 3D 预览（rotation + zoom），不需要任何 CAD 软件，零配置，这对于快速迭代验证场景非常有价值。

特点

• 全格式覆盖：STEP（主）、STL、3MF、GLB、DXF、URDF、SRDF、SDF、G-code，一个库搞定工程文件全家桶
• 本地几何计算：OpenCASCADE 内核跑在本地 Python 环境，不需要云端 API，不上传任何设计数据
• 模块化 Skill 设计：按工件类型独立安装，不需要为每个任务背一整条工具链，按需加载
• 零配置 3D 预览：CAD Viewer 技能自动打开浏览器预览，已生成模型触手可及
• 完整制造链路：不只是建模，延伸至切片（G-code）、打印（Bambu Lab 直传）、标准件查询（step.parts）

使用方法

前置依赖：Python 3.11+、Node.js 18+

通过 Skills CLI 安装（推荐）：

npx skills add earthtojake/text-to-cad

按子技能安装：

npx skills add earthtojake/text-to-cad --skill cad
npx skills add earthtojake/text-to-cad --skill urdf

Claude Code 插件方式：

/plugin marketplace add earthtojake/text-to-cad
/plugin install cad@text-to-cad

Codex（需要 0.142.0+）：

codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad

装完后重启 Agent，新 Skill 即自动加载。

使用场景与人群

• 硬件/Maker 创客：用自然语言描述零件，直接拿到 STEP 文件上打印机
• 机器人工程师：URDF/SRDF/SDF 技能生成机器人描述文件，接 MoveIt / Gazebo 仿真
• CAD 二次开发：DXF 输出接激光切割，step.parts 查标准件，直接集成进自动化流程
• AI Agent 开发者：在 Agent 的 Skill 链路上补全「工程文件」这一缺失环节

输入与输出案例

案例 1：自然语言 → STEP 文件

输入（对 Claude Code 说）：

设计一个 L 型支架，底部板 60×20×3mm，竖直板 20×40×3mm，用 M3 螺丝，四个角各一个安装孔，底部倒圆角 R3

输出：
– models/L_bracket.step（可直接用 SolidWorks/Fusion360 打开的 STEP 文件）
– 浏览器自动弹出 3D 预览，可旋转缩放检查拓扑正确性

案例 2：自然语言 → 完整 URDF + 仿真世界

输入：

为一个两轮差速机器人写 URDF，车身 20cm×15cm×10cm，两轮直径 8cm，居中安装，添加激光雷达支架

输出：
– robot.urdf（含 links/joints/limits/inertials/meshes）
– robot.srdf（MoveIt 规划组+末端执行器+碰撞规则）
– simulation.sdf（含 physics/sensors/lights 的 Gazebo 世界文件）

GitHub: https://github.com/earthtojake/text-to-cad