这个 Skill 能做什么，适合哪些场景？
engineering-drawing 是 earthtojake/text-to-cad 技能库中的一员，用于把一个已建好的三维零件（STEP 文件或 build123d 实体）变成一份可供车间使用的工程图 PDF。它通过 cadgen 0.7.20（经 uv 运行）从零件几何中投影出正交视图，自动测量并放置尺寸、孔位标注和注释，排布在带图框和标题栏的 ISO 图纸上。图纸上没有任何手绘线条或手填数字——尺寸直接来自几何测量，改了模型重跑脚本，视图和数值随之更新。输出只有一个 PDF，不写 DXF，也没有 CLI：脚本身就是接口。
- 读取 STEP 文件（如 @step 模型生成的产物）或运行中的 build123d 实体，作为制图对象。
- 用 sheet.three_views() 生成第三角投影的顶、前、右三个视图（可选等轴测视图），支持自定义视图位置与 A3/A4 等图幅。
- 在模型坐标系中放置尺寸：总体尺寸、特征位置（可带公差 tol= 或配合 fit=）、孔标注（通孔/深度/沉头/锪平/螺纹）和引线注释。
- 按 VISIBLE/HIDDEN/CENTER 等图层以不同线宽输出，含隐藏线和中心标记。
- 生成带标题栏（图号、材料、比例、投影方式、修订等）、编号注释和可选修订表的 ISO 图纸，输出确定性 PDF（不含创建时间戳）。
- 在绘制过程中报告测量问题（如尺寸落在空白处、注释重叠），参数错误时直接报错而不产出错误图纸。
- [$d$
- 机械工程师用 Claude Code 建完零件模型后，需要一张可发给车间的带尺寸制造图纸，而不是再花时间在 CAD 软件里手动出图。
- 设计迭代频繁的团队：模型修改后只需重跑绘图脚本，视图、隐藏线和尺寸数值自动跟随，避免手工改图遗漏。
- 需要规范化出图的独立开发者或小工作室：ISO 图幅、标题栏、修订表自动生成，且每次重建生成完全相同的 PDF 便于版本管理。
- 向 Agent 提出『给这个零件出 2D 视图』或『出加工图』的用户，技能由描述触发，自动走读取模型、写脚本、出 PDF 的流程。
- 想在交付物中明确公差和注释的制造对接人：只有显式写出的 tol=/fit=/general_tolerance= 会出现在图上，不会被凭空编造。]
- 需要剖视图（sections）、局部放大图（details）或辅助视图（auxiliary views）的用户——SKILL.md 明确说这些还不支持，只能在交接中说明视图未展示的内容。
- 需要 DXF 切割排版或展开图的用户——该技能明确不写 DXF，那属于库中的 DXF 技能，是不同的工作。
- 不想装 uv/Python 运行时、或希望有图形界面/CLI 的用户——本技能没有 CLI，脚本即接口，且 Windows 11 的 Smart App Control 开启时 OCP 内核会加载失败。
如何安装这个 Skill？
- 静态审查，未执行任何脚本；产出质量与失败行为均未经实际复现。
- 首次运行需从 PyPI 下载 cadgen==0.7.20 及依赖（matplotlib 等），中国大陆网络可达性未验证；无中文文档。
- cadgen 默认发送遥测（不含文件内容），可在安装后通过 `uvx cadgen telemetry off` 或 DO_NOT_TRACK=1 关闭。
- 标注不与线稿做冲突检查，需人工读 PDF 校对；公差必须由用户提供，技能不会代为虚构。
- Windows 11 开启 Smart App Control 时 OCP 原生模块会被拦截导致 cadgen 不可用（需关闭该功能或改用 WSL）。
- Shell / 命令行
- 网络访问
- 本地文件系统
uvcadgen 0.7.20 (installed via uvx, Python 3.13)matplotlib (rendering backend)
本技能属于 text-to-cad 技能库（内含 13 个技能），需安装整个库后使用 engineering-drawing 这一项。Claude Code 插件方式：
claude plugin marketplace add earthtojake/text-to-cad#latest
claude plugin install text-to-cad@earthtojake安装后重启应用即可（首次启动会下载 CAD 运行时，需联网）。Cursor 本地插件方式：
git clone --depth 1 --branch latest https://github.com/earthtojake/text-to-cad ~/.cursor/plugins/local/text-to-cad克隆后重启 Cursor。Grok 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其他 Agent（Skills CLI，仅装技能不含 CAD 服务器）：
npx skills add earthtojake/text-to-cad#latest前置条件：所有方式都要求已安装 uv（uv --version 检查），技能运行时通过 uvx 以固定命令调用 cadgen 0.7.20。同一应用内装插件或装技能二选一，不要两个都装。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 给这个零件出一张带尺寸标注的工程图 PDF，用 A3 横版第三角投影
- 我改了法兰的孔距，重新生成制造图纸，把每个孔都加上中心标记和通孔标注
- 输出这个支架的 2D 视图和加工图，总体尺寸和壁厚标公差 ±0.1
- 把这个 STEP 文件画成带标题栏和修订表的正式图纸，加上『去毛刺』注释
技能由 SKILL.md 描述触发：当用户要求『出图』『尺寸标注图』『加工图』『打印图』或『这个零件的 2D 视图』时启用。典型流程：1) 先运行零件模型脚本 python <model>.py 生成 STEP（或直接用 build123d 实体），再用 cadgen.read_step() 读取；2) 依照技能附带的模板（references/sheet-api.md#template）在模型旁写 <name>_drawing.py，尺寸引用模型模块中的事实（孔距、总尺寸、壁厚）而非重打数字；3) 用 sheet.three_views(part, iso=True) 布置视图（返回四个视图：三视图加角落等轴测）；4) 用 view.overall()、view.dim、view.hole、view.note 标注制造所需的尺寸，通常不填 text 让其自动测量；5) 运行：
python <name>_drawing.py脚本输出 PDF 路径及绘制时发现的问题（如『measures blank paper』『annotation overlaps』），需先读这些提示修正；6) 打开 PDF 检查文字是否压线、隐藏线是否正确、每个孔是否有中心标记，调整 at=/offset= 后重跑。注意：cadgen 通过 uv 运行，完整命令形如 uvx --no-config --managed-python --python 3.13 --from cadgen==0.7.20 cadgen；无人值守运行时设 MPLCONFIGDIR 指向可写目录以免字体缓存告警。
这个 Skill 有哪些优点和局限？
- 尺寸、中心标记、视图全部从零件几何投影测量，改模型重跑即可，图与模型永不脱节。
- 输出一个确定性 PDF（无创建时间戳，内容不变则字节不变），便于版本对比和归档。
- 失败即报错：参数非法、视图出框、缺渲染器时直接抛异常，不产出错误或缺失的图纸。
- 参数校验细致：非法视图名/图幅/投影、错误公差格式、过宽注释等都会被明确拒绝并说明原因。
- 不支持剖视图、局部放大图和辅助视图，复杂零件的表达受限。
- 没有 CLI，也没有 DXF 输出，脚本即接口，对想集成到现有工具链的用户不够灵活。
- 技能不检查注释与线条是否重叠，需要人工打开 PDF 复核。
- 公差不会自动生成，全靠用户显式提供，否则默认名义值——不适合作者不熟悉公差标注的场景。
- 整个 text-to-cad 默认发送匿名使用统计和崩溃报告，需主动执行 `uvx cadgen telemetry off` 关闭。
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Engineering Drawing（工程图纸生成） 本页 | 59 · 推荐 | ★ 19k | 1 天前 | MIT |
| DXF 生成与校验技能 | 57 · 谨慎使用 | ★ 19k | 1 天前 | MIT |
| SendCutSend 上传预检 | 57 · 谨慎使用 | ★ 19k | 1 天前 | MIT |
| 桌面指挥官 MCP（Desktop Commander MCP） | 65 · 推荐 | ★ 10k | 4 天前 | MIT |
| G-code 切片技能（text-to-cad） | 60 · 推荐 | ★ 19k | 1 天前 | MIT |
同库中的 DXF 技能生成的是切割排版和展开图（刀路用途），而本技能产出的是文档性质的工程图 PDF——SKILL.md 明确指出二者是不同的工作，按需选择。
FollowSkills 如何评估这个 Skill？
该技能为纯本地文档生成工作流：从 STEP 读取几何、由脚本渲染 PDF，不写 DXF、无网络副作用、无凭证处理；版本通过 uvx 固定到 cadgen==0.7.20，供应链可见。README 明确披露默认遥测及其关闭方式（与该技能共享安装），SECURITY.md 说明查看器仅绑定回环。扣分项：缺少用户确认机制与隔离/回滚说明，遥测默认开启（虽可关闭），发布者未经验证、归属仅是仓库链接。
文档自洽性高：模板、API 参考、失败模式（'measures blank paper'、'annotation overlaps'、视图越界报错、缺渲染器即失败不留文件）描述具体，异常输入被拒绝的清单详尽。但静态审查无法执行关键路径；仓库有 CI 徽章（test.yml），未见覆盖本技能图纸路径的已提交测试，故按锚点封顶于 10。
触发条件清晰（'drawing'、'dimensioned sheet'、'2D views of this part'），明确声明非适用范围：无剖视、局部详图、辅助视图，不出 DXF，公差须由用户提供不可虚构。扣分项：依赖 uv/PyPI 首次下载与 matplotlib 等外部依赖，在中国大陆网络可达性未验证；无中文支持说明。
SKILL.md 与 references/sheet-api.md 分层良好（工作流→API→限制），MIT 许可明确，provenance 指向仓库，cadgen 版本固定 0.7.20，更新路径（uvx 缓存、插件更新）在 README 中说明。扣分项：技能自身无变更日志/版本历史，依赖外部 PyPI 包的版本演进，已知限制部分依赖用户'读 PDF'自查。
声称产出是直接可交付车间的单页 PDF，且确定性（不盖时间戳，重建字节相同），相对手工绘图有明确边际价值。但静态审查无法验证输出质量，代表性产出未在源文件中提供，按静态封顶 7 计并因缺少样例产出证据而保守。
主要声明可追溯到仓库内源文件与固定版本参数，README 提供 PyPI/CI 徽章等第三方信号，但技能自身关键路径（三维视图投影、标注渲染）无已提交测试或独立复现证据，事实与推断边界基本清晰但覆盖薄，封顶 5 以内计 4。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →