前言¶
在 Agent 里写 CAD，常见做法是让模型「描述形状」或零散生成脚本，却很难稳定落到可交换的 STEP、可复用的参数化模型，以及装配体级别的检查与验证。手工在桌面 CAD 里改尺寸、对照 2D 图纸或参考图重建零件，又会打断和 AI 协作的节奏。
下面介绍 SkillHub 上的社区 Skill「文本转cad文件」（@user_64e186fe/txt-to-cad，v1.0.0）。它把自然语言、规格说明、参考图与 2D 技术图作为输入，围绕 STEP 优先的参数化零件与装配体，覆盖创建、修改、检查与验证，并支持 build123d 建模与多种次级导出格式。
这是什么¶
「文本转cad文件」是 SkillHub 社区来源（community）的 dev-programming 类 Skill，由发布者 user_64e186fe 维护。页面标注 requires_api_key=false，即按 SkillHub 说明安装后使用，不依赖额外 API Key 配置。
一句话定位：在支持 Agent Skills 的客户端里，用自然语言（并可结合 CAD 规格、参考图像、2D 技术图纸）驱动参数化 CAD 工作流，以 STEP/STP 为主交付，同时可产出 Python CAD 源码、几何测量与快照，以及 STL、3MF、原生 GLB 等次级输出。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在资料中出现的细节不展开。
-
STEP 优先的参数化零件与装配体
创建、修改、检查与验证以 STEP 为中枢的零件和装配体，支持直接生成或检查 STEP/STP 文件。 -
多源输入
除自然语言外，明确适用于 CAD 规格、参考图像、2D 技术图纸等输入形式。 -
Python CAD 与 build123d
可涉及 Python CAD 源代码；建模栈支持 build123d，包括参数化设计、装配体创建与自动验证。 -
几何信息与可视化辅助
支持几何事实、测量、快照等，用于核对模型是否符合描述或图纸。 -
次级格式导出
在 CAD 几何体基础上可生成 STL、3MF、原生 GLB 等输出，便于打印、预览或下游工具链。
安装与启用¶
SkillHub 页面给出的安装方式是：让当前 Agent 按官方安装文档处理坐标 @user_64e186fe/txt-to-cad。文档地址为 SkillHub 安装与优先源配置。
1、确认 skillhub CLI¶
先检查本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可按安装文档执行完整安装（CLI + 默认 Skill）或仅 CLI：
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录；文档说明默认装到 ./skills/ 可能不会被 Agent 加载。
skillhub install @user_64e186fe/txt-to-cad --dir <skills 目录>
常用路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示词发给支持 Skills 的 AI，由其按同一文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_64e186fe/txt-to-cad`。
安装后按你所用客户端的要求刷新或重启，使新 Skill 生效。资料中未区分 Cursor、Codex CLI、Claude Code 的额外配置项，此处不臆造差异说明。
典型用法¶
官方页面未提供带具体尺寸或文件名的逐步教程，可复现的部分主要是安装坐标与能力边界。结合简介，可按下面顺序在对话中使用（表述需与你手头规格、图纸一致）：
-
说明目标与约束
用自然语言写清零件或装配关系；若有 CAD 规格表、参考图或 2D 技术图，一并提供给 Agent，并说明期望主交付为 STEP/STP。 -
迭代参数与装配
需要改尺寸、加特征或调整装配时，继续用自然语言描述变更；Skill 侧支持参数化设计与装配体创建，并带自动验证取向。 -
检查与测量
要求对已有 STEP 做检查，或输出几何事实、测量结果、快照，用于对照图纸或规格。 -
导出次级格式
在几何确认后，再要求从同一 CAD 几何生成 STL、3MF 或原生 GLB，用于打印或预览链路。
示例安装提示（与 SkillHub 页面一致，可直接复制）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_64e186fe/txt-to-cad`。
适用场景与注意¶
适合谁
- 需要在 Agent 会话里快速从文字/图纸意图落到 STEP 参数化模型或装配体的开发者或机械设计协作方。
- 希望同时保留 build123d/Python 建模路径，并做自动化验证，而不是只得到不可追溯的网格文件。
- 需要 STEP 为主、STL/3MF/GLB 为辅的多格式交付场景。
限制与注意
- 社区 Skill（
community），行为与文档以 SkillHub 页面及包内SKILL.md为准；本文不描述未在官方简介出现的工具版本或环境依赖。 - SkillHub 统计（截至页面展示）：评分 100000，下载 2035，安装 0——安装数为平台统计字段，实际是否已装入本机需自行在 skills 目录确认。
- 复杂装配与图纸歧义仍依赖你提供的规格质量；自动验证能减少明显错误，不能替代工程审图与实物试装。
- 未要求 API Key，但若你本地 Python/CAD 运行环境缺失，仍需自行补齐，资料中未给出固定安装清单。
结尾¶
「文本转cad文件」把自然语言与图纸类输入接到 STEP 优先的参数化 CAD 流程上，并覆盖 build123d 建模、检查验证与多种导出，适合在 Agent 里做可交换、可迭代的机械几何工作。安装与坐标以 SkillHub 为准：
- Skill 页面：https://www.skillhub.cn/skills/user_64e186fe/txt-to-cad
- API 坐标页：https://api.skillhub.cn/user_64e186fe/txt-to-cad
