████████╗███████╗██╗ ██╗████████╗██████╗ ██████╗ █████╗ ██████╗ ╚══██╔══╝██╔════╝╚██╗██╔╝╚══██╔══╝╚════██╗██╔════╝██╔══██╗██╔══██╗ ██║ █████╗ ╚███╔╝ ██║ █████╔╝██║ ███████║██║ ██║ ██║ ██╔══╝ ██╔██╗ ██║ ██╔═══╝ ██║ ██╔══██║██║ ██║ ██║ ███████╗██╔╝ ██╗ ██║ ███████╗╚██████╗██║ ██║██████╔╝ ╚═╝ ╚══════╝╚═╝ ╚═╝ ╚═╝ ╚══════╝ ╚═════╝╚═╝ ╚═╝╚═════╝
面向 CAD、CAE 和 CAM 的智能体技能库
徽章：Tests | 加入 Discord | GitHub Stars | License: MIT | 关注 @earthtojake | Python 3.11+ | STEP 导出 | STL 导出 | 3MF 导出 | URDF 机器人 | SDF 仿真 | SRDF MoveIt2
text-to-cad
text-to-cad 是一个智能体（agent）技能库，可用于从本地项目文件生成、检查、获取、切片以及交付 CAD 与机器人描述产物。
CAD | 
URDF | 
SRDF / MoveIt2 |
🧰 技能
安装本技能库后，智能体即可获得针对 CAD、制造加工、机器人描述文件、仿真和本地预览的专项工作流。
| 技能 | 简介 | 来源 |
|---|---|---|
| CAD | 根据自然语言或图像请求创建和编辑 CAD 模型，以 STEP 为主要输出格式，并可选择导出为 STL、3MF 和 GLB。 | skills/cad |
| CAD Viewer | 在本地浏览器中预览 CAD 和机器人文件。 | skills/cad-viewer |
| step.parts | 查找现成的 STEP 零件，如螺丝、轴承、电机和连接器。 | skills/step-parts |
| DXF | 从 Python 源码或 CAD 几何体创建 2D DXF 图纸，如轮廓、模板、垫片和切割排样。 | skills/dxf |
| URDF | 编写包含连杆、关节、限位、惯量与网格的机器人结构文件。 | skills/urdf |
| SRDF | 为 URDF 添加 MoveIt 规划组、末端执行器、位姿和碰撞规则。 | skills/srdf |
| SDF | 创建包含坐标系、物理、传感器和灯光的仿真模型与世界。 | skills/sdf |
| SendCutSend | 在上传到 SendCutSend 之前检查 DXF 和 STEP 文件。 | skills/sendcutsend |
| Dfam Check | 按工艺测量网格的可打印性：壁厚、悬垂、支撑体积和构建方向。 | skills/dfam-check |
| G-code | 使用真实切片器 CLI 将受支持的网格文件切片为经过验证、匹配打印机配置文件的 FDM .gcode。 | skills/gcode |
| Bambu Labs | 对经过验证的 .gcode 进行试运行、上传，并谨慎地启动本地 Bambu Lab 打印任务。 | skills/bambu-labs |
💻 安装
从 main 分支安装或克隆：它是源码树，每个技能的 requirements.txt 都固定了其发布时对应的 cadgen 版本。（models/ 测试数据集以小型 LFS 指针形式提供，使用这些技能并不需要它。）
技能
使用 Skills CLI 安装 text-to-cad：
npx skills add earthtojake/text-to-cad
这是推荐的安装方式。它会直接为受支持的智能体安装各个独立技能。
使用同一命令进行更新。add 会重新拉取软件包并覆盖已安装的内容，因此既能刷新现有技能，也能安装新版本中新增的技能。npx skills update 只会刷新锁文件中已有的技能，因此会静默遗漏新增技能——这一点在这里很重要，因为版本发布确实会增加新技能。
这两个命令都不会移除上游已弃用的技能；如有需要，可使用 npx skills remove <skill> 删除。
（npx skills install … 仍然可用——它是 add 的一个未在文档中说明的别名。）
插件
Codex、Claude Code 和 Grok Build 也支持各自原生的插件安装方式：
# Codex（需要 Codex 0.142.0 或更新版本）
codex plugin marketplace add earthtojake/text-to-cad
codex plugin add cad@text-to-cad
Codex 仅从 0.142.0 版本起才会解析这个仓库根目录的插件。在更旧的版本中，该插件会被静默跳过，且不会出现在 codex plugin list 中；可使用 npm install -g @openai/codex@latest 升级。
# Claude Code
claude plugin marketplace add earthtojake/text-to-cad
claude plugin install cad@text-to-cad
Grok Build 使用现有的 .claude-plugin/marketplace.json，没有单独的 Grok 插件清单。
# Grok Build
grok plugin install earthtojake/text-to-cad --trust
grok plugin enable cad
如果新安装的技能没有出现，请重启你的智能体。本地开发时，请从 main 分支创建分支，针对 main 提交 PR，并遵循 CONTRIBUTING.md。
🛠️ 参与贡献
从 main 分支创建分支，并针对 main 提交 PR。
有关本地贡献流程、技能链接和验证指南，请参阅 CONTRIBUTING.md。