前言¶
在 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
