这个 Skill 能做什么，适合哪些场景？
这是 text-to-cad 仓库中的 CAD 技能，面向机械零件与装配体的三维建模。它指导智能体编写带有装饰器的 Python 模型脚本（基于 build123d），由 pinned 版本的 cadgen 命令行工具本地构建为 STEP，并可维护性地产出 STL、3MF、GLB 网格。技能还覆盖项目管理、从提示词引用解析几何、几何测量校验、快照自检，以及在 CAD Viewer 中打开并展示现有 STEP/STP、STL、3MF 和 GLB 文件。整库以 MIT 许可发布，需通过 uv 运行，首次使用会下载运行时。
- 读取/编辑带 @step 装饰器的 build123d Python 模型脚本，运行 python <model>.py 生成 STEP 文件
- 通过 @stl/@threemf/@glb 装饰器或 cadgen stl/3mf/glb build 命令导出网格格式
- 用 read_scene + scene.resolve() 解析如 /path/assembly.step#o1.2.f7 的提示词几何引用并测量面积等属性
- 编写 Python 几何检查脚本校验尺寸、间隙与拓扑，并用 cadgen step snapshot 渲染快照自审
- 启动本地 CAD Viewer（cadgen viewer --detach）或用 cad_show 向用户展示模型
- 通过 cadgen doctor 诊断安装与内核加载问题，cadgen store why 解释意外重建
- 机械工程师让智能体根据口头描述或带标注的图片生成一个支架零件的参数化 STEP 模型
- 机器人团队整理多模型 CAD 项目（src/ 目录、模型目录、格式化输出文件夹）并维护装配体
- 3D 打印用户把已有的 STEP 零件一次性导出为 STL 或 3MF
- 收到 CAD Viewer 快速编辑笔记（含文件路径、引用和草图）的智能体，定位并修改对应几何
- 评审者用快照和几何检查核对零件尺寸、间隙后向用户交付结果
- 需要 2D DXF 图纸的用户——SKILL.md 明确要求改用 $dxf 技能
- 需要 URDF/SRDF/SDF 机器人描述文件的用户——技能要求使用对应的 robot-description 技能
- 未安装 uv 且无法联网的离线受限环境——首次运行必须下载 cadgen 运行时与快照用无头浏览器
如何安装这个 Skill？
- 静态审查，未执行任何命令；所有能力主张仅基于文档。
- cadgen 默认发送匿名使用统计与崩溃报告（PostHog），如不接受请先运行 `uvx cadgen telemetry off` 或设置 CADGEN_TELEMETRY=0。
- CAD Viewer 本地服务无认证（仅 loopback），不要绑定非 127.0.0.1 主机或暴露到本机之外。
- 首次运行会从外网下载运行时与无头浏览器；中国大陆网络环境下 uv/PyPI/浏览器下载可能不可达或缓慢，未提供镜像说明。
- 无中文支持；Windows 11 Smart App Control 会阻止未签名的 OCP 原生模块，需关闭或使用 WSL。
- 发布者未经验证，仓库含 13 个 skill，本评分仅针对 skills/cad/SKILL.md。
- Shell / 命令行
- 网络访问
- 本地文件系统
uv / uvxPython 3.13 (uv-managed)cadgen 0.7.20 (pinned via uvx)
本技能随 text-to-cad 技能库一起安装（库含 13 个技能，本技能位于 skills/cad/SKILL.md）。需先安装 uv。
Claude Code
claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojakeCursor
git clone --depth 1 --branch latest https://github.com/earthtojake/text-to-cad ~/.cursor/plugins/local/text-to-cadGrok Build
grok plugin install earthtojake/text-to-cad@latest --trust
grok plugin enable text-to-cadGemini
gemini extensions install https://github.com/earthtojake/text-to-cad --ref latest --consent --auto-update其他智能体（Skills CLI）
npx skills add earthtojake/text-to-cad#latestClaude Desktop 无技能安装命令，仅提供 MCP 服务器配置（cadgen mcp，pinned cadgen==0.7.20），需手动加入 config 后重启。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 创建一个 40mm 宽、20mm 深、6mm 厚的支架零件，导出 STEP 和 STL 文件
- 把 /work/robot/STEP/assembly.step 里的装配体导出成 GLB 给我用浏览器查看
- 这张手绘草图上的零件尺寸如下，帮我建出参数化模型并说明你做的假设
- 打开 viewer 给我看看刚才生成的 bracket.step，并检查孔位间距是否符合图纸
安装后向智能体描述建模任务即可触发；技能按任务路由到 references/ 下的说明文档。核心流程是：找到或新建一个带装饰器的 Python 模型脚本（如 src/bracket.py，内含 @step(out="../STEP/bracket.step")），编辑后运行：
python src/bracket.py其中 python 和 cadgen 均为 pinned 的 uvx 命令（--python 3.13 --from cadgen==0.7.20）。一次性网格导出：
cadgen stl build STEP/bracket.step STL/bracket.stl
cadgen 3mf build STEP/bracket.step 3MF/bracket.3mf
cadgen glb build STEP/bracket.step GLB/bracket.glb几何检查需自己写 Python 脚本（无 inspect CLI，临时检查放 tmp/，可复用的放 checks/）。生成或修改几何后必须渲染并自行阅读至少一张快照：
cadgen step snapshot STEP/bracket.step tmp/review.png向用户展示模型优先用 cad_show 工具，否则运行 cadgen viewer --host 127.0.0.1 -- --detach（务必带 --detach），从 JSON 输出读取 url 并拼上 ?file=<URL编码的绝对路径>。装配体在父模型中调用子模型并用 .moved() 或 Location * shape 定位；命名的外购件先搜索 $step-parts 再做占位。
这个 Skill 有哪些优点和局限？
- 纯本地工作流，模型文件不出本机，MIT 许可
- 以 STEP 为主输出的同时可维护性地产出 STL/3MF/GLB，覆盖主流下游用途
- 工作流完整：建模、项目组织、引用解析、几何校验、快照自审、查看器展示、失败修复闭环均有文档
- 通过 uv 固定 cadgen==0.7.20 与 Python 3.13，配合 cadgen doctor 便于诊断环境问题
- 强依赖 uv 与首次联网下载（运行时 + 无头浏览器），离线首用不可行
- 整库默认发送使用统计与崩溃报告（可关闭），且每日一次的版本检查请求需知晓
- Windows 11 上 Smart App Control 开启时会因 OCP 未签名原生模块导致所有 cadgen 命令失败，需关闭该控制或改用 WSL
- 技能只规定流程，几何正确性仍取决于模型代码；快照与检查由智能体自行执行，无独立验证保证
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| CAD（text-to-cad 之 CAD 技能） 本页 | 55 · 谨慎使用 | ★ 19k | 1 天前 | MIT |
| DfAM Check —— 3D 打印可制造性检查 | 67 · 推荐 | ★ 19k | 1 天前 | MIT |
| 3D Morph PPT 扩展技能 | 48 · 谨慎使用 | ★ 32k | 5 天前 | Apache-2.0 |
| 学术配图提示词生成器（现代柔彩 ML 风格） | 68 · 推荐 | ★ 2.6k | 6 个月前 | MIT |
| Banana Claude —— Gemini 图像创作指挥技能 | 59 · 推荐 | ★ 1.1k | 1 个月前 | MIT |
README 将本技能定位为库中 13 个技能之一：与 step.parts（查找现成外购 STEP 件）、DXF（2D 图纸）、URDF/SRDF/SDF（机器人描述）以及 DfM/SendCutSend/G-code 等制造技能互补；本技能负责 3D 参数化建模与导出本身。源材料未提及其他第三方竞品。
FollowSkills 如何评估这个 Skill？
证据显示：skill 本身全部为本地文件操作，无凭证访问、隐蔽外传或破坏性默认；版本固定（cadgen==0.7.20、uv --no-config）、telemetry 默认开启但有完整披露与关闭途径（README）、查看器 loopback 绑定且 SECURITY.md 明示无认证边界。扣分项：telemetry 默认发送（虽可关闭）、本地查看器无认证、首次运行从外网下载运行时与无头浏览器，且发布者身份未经注册表验证，恢复/回滚路径仅部分说明。未达满分。
文档自洽度极高：明确的命令契约、doctor 诊断、迁移指南、失败反馈（teaching error、refusal with reasons）设计良好；静态审查未发现矛盾。扣分项：静态评审上限 10，关键路径（cadgen 构建/快照/查看器）无可执行的复现证据，测试套件未在本次证据中呈现。
任务表清晰覆盖建模/导出/检查/动画/迁移等场景，边界声明详尽（如闭环连杆 out of scope、mesh-only 限制）。扣分项：核心功能依赖 uv/PyPI 下载、ffmpeg、外网首装，未说明中国网络可达性；无中文支持；触发条件依赖用户知道 $cad 语法，语义触发精度证据有限。
分层文档（SKILL.md + 多个 references）+ 渐进披露、迁移指南、MIT 许可、版本固定与 pin 检查（cadgen doctor）都很完善。扣分项：无独立 changelog/版本历史指向 skill 本身，维护者责任仅通过仓库 README 间接体现，发布者未验证，部分引用的 references 文件未在本次证据中出现。
目标、方法、替代方案（脚本 vs step build、snapshot vs viewer）论述清楚，输出为可直接使用的 STEP/STL/3MF/GLB 并强制自检快照。扣分项：静态评审上限 7，无已执行的代表输出可验证直接可用性，全部收益主张仅来自文档。
README 显示 CI 测试徽章与 PyPI 版本徽章，docs 引用外部迁移文档，属于可审计的一手材料。扣分项：静态评审上限 5，本次证据未包含 skill 关键路径的实际测试文件或第三方执行结果，多来源交叉验证不足。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →