CAD Skills 如何安裝:讓 Codex 和 Claude Code 產生 STEP、DXF、URDF 與 G-code

text-to-cad CAD Skills 安裝與驗收指南,覆蓋 Codex/Claude Code 外掛程式、STEP/DXF/URDF/G-code 輸出、尺寸驗證、切片和列印安全。

CAD Skills 的本篇教學圍繞著標題中的具體任務。 STEP、DXF、URDF 與 G-code 面向不同製造或機器人流程;Agent 產生檔案後必須用獨立檢視器核對單位、座標、閉合輪廓和加工邊界。

下面使用測試環境和可撤銷資料演示。涉及帳號、金鑰、機器控制、投資或緊急通訊時,必須再做人工確認。

四種輸出格式先依用途選擇

這一節只處理「四種輸出格式先依用途選擇」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
Get-ChildItem -Name

對 CAD Skills 來說,判斷結果時必須結合這個邊界:STEP、DXF、URDF 與 G-code 面向不同製造或機器人流程;Agent 產生檔案後必須用獨立檢視器核對單位、座標、閉合輪廓和加工邊界。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

安裝 Skill 與安裝 CAD 核心是兩回事

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
Get-Command codex, python -ErrorAction SilentlyContinue

完成標準是「安裝 Skill 與安裝 CAD 核心是兩回事」得到可核驗結果,而不是命令剛好沒有報錯。

第一個 STEP 只做有孔方塊

檢查項 通過標準 停止訊號
第一個 STEP 只做帶孔方塊 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
# 固定单位为 mm,并写明长宽高与孔径

出現停止訊號時先恢復,不要繼續下一步。

用獨立 CAD 檢視器檢查實體

這一節只處理「用獨立 CAD 檢視器檢查實體」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
Get-ChildItem -Filter *.step

對 CAD Skills 來說,判斷結果時必須結合這個邊界:STEP、DXF、URDF 與 G-code 面向不同製造或機器人流程;Agent 產生檔案後必須用獨立檢視器核對單位、座標、閉合輪廓和加工邊界。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

DXF 重點檢查閉合輪廓和圖層

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
Get-ChildItem -Filter *.dxf

完成標準是「DXF 重點檢查閉合輪廓和圖層」得到可核驗結果,而不是指令剛好沒有報錯。

URDF 要同時驗證 mesh 與 joint

檢查項 通過標準 停止訊號
URDF 要同時驗證 mesh 與 joint 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
Get-ChildItem -Recurse -Filter *.urdf

出現停止訊號時先恢復,不要繼續下一步。

G-code 絕對不能直接交給機器

這一節只處理「G-code 絕對不能直接交給機器」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
Get-ChildItem -Filter *.gcode

對 CAD Skills 來說,判斷結果時必須結合這個邊界:STEP、DXF、URDF 與 G-code 面向不同製造或機器人流程;Agent 產生檔案後必須用獨立檢視器核對單位、座標、閉合輪廓和加工邊界。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

單位錯誤 25.4 倍從哪裡產生

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
Select-String -Path *.dxf,*.gcode -Pattern 'inch|mm' -ErrorAction SilentlyContinue

完成標準是「單位錯誤 25.4 倍從哪裡產生」得到可核驗結果,而不是命令剛好沒有報錯。

座標原點應該寫入任務說明

檢查項 通過標準 停止訊號
座標原點應該寫入任務說明 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
# 指定右手坐标系、原点和正方向

出現停止訊號時先恢復,不要繼續下一步。

公差不是讓 Agent 自己猜

這一節只處理「公差不是讓 Agent 自己猜」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
# 明确尺寸公差、孔配合与材料

對 CAD Skills 來說,判斷結果時必須結合這個邊界:STEP、DXF、URDF 與 G-code 面向不同製造或機器人流程;Agent 產生檔案後必須用獨立檢視器核對單位、座標、閉合輪廓和加工邊界。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

外部轉換器的版本要記錄

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
python --version

完成標準是「外部轉換器的版本要記錄」得到可核驗結果,而不是指令剛好沒有報錯。

產生前後比較檔案體積和實體數

檢查項 通過標準 停止訊號
產生前後比較檔案體積和實體數 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
Get-ChildItem *.step,*.dxf,*.urdf,*.gcode -ErrorAction SilentlyContinue

出現停止訊號時先恢復,不要繼續下一步。

切片與模擬是 G-code 前置驗收

這一節只處理「切片與模擬是 G-code 前置驗收」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
# 在离线仿真器中检查路径、速度和限位

對 CAD Skills 來說,判斷結果時必須結合這個邊界:STEP、DXF、URDF 與 G-code 面向不同製造或機器人流程;Agent 產生檔案後必須用獨立檢視器核對單位、座標、閉合輪廓和加工邊界。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

機器人模型先做靜態載入

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
# 在可视化工具中检查 link 和 joint

完成標準是「機器人模型先做靜態載入」得到可核驗結果,而不是命令剛好沒有報錯。

返工時只改一個幾何參數

檢查項 通過標準 停止訊號
返工時只改一個幾何參數 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
git diff --stat

出現停止訊號時先恢復,不要繼續下一步。

交付時儲存規格與驗證截圖

這一節只處理「交付時保存規格與驗證截圖」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
git status --short

對 CAD Skills 來說,判斷結果時必須結合這個邊界:STEP、DXF、URDF 與 G-code 面向不同製造或機器人流程;Agent 產生檔案後必須用獨立檢視器核對單位、座標、閉合輪廓和加工邊界。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

尺寸公差與幾何約束分開描述

建議按以下順序執行:

  1. 核對實際版本與來源。
  2. 使用測試帳號、測試目錄或測試設備。
  3. 執行一個可撤銷動作。
  4. 儲存輸出、退出碼或截圖。
  5. 恢復修改並重新驗證。
1
# 分别记录名义尺寸、公差和约束关系

完成標準是「尺寸公差與幾何約束分開描述」得到可核驗結果,而不是命令剛好沒有報錯。

STEP 與 DXF 以相同基準尺寸互驗

檢查項 通過標準 停止訊號
STEP 與 DXF 以相同基準尺寸互驗 輸入、輸出和權限範圍明確 工具自動擴大操作範圍
來源 能回到官方倉庫或原始資料 依賴未知鏡像或二手結論
安全 日誌中沒有秘密值 出現 Token、Cookie 或隱私資料
復原 能回到執行前狀態 沒有備份或撤銷方法
1
Get-ChildItem *.step,*.dxf -ErrorAction SilentlyContinue

出現停止訊號時先恢復,不要繼續下一步。

交付文件要附帶單位與座標說明

這一節只處理「交付文件要附帶單位與座標說明」。先保存目前狀態,再執行最小測試,不要同時改變多個條件。

1
Get-ChildItem *.md,*.step,*.dxf -ErrorAction SilentlyContinue

對 CAD Skills 來說,判斷結果時必須結合這個邊界:STEP、DXF、URDF 與 G-code 面向不同製造或機器人流程;Agent 產生檔案後必須用獨立檢視器核對單位、座標、閉合輪廓和加工邊界。

如果結果無法重複,記錄版本、輸入和日誌,然後縮小測試範圍。

CAD Skills 的最終核對

  • 使用的版本和來源已經記錄。
  • 測試輸入與正式資料已經隔離。
  • 命令、配置和實際輸出能夠對應。
  • 失敗路徑至少主動測試過一次。
  • 金鑰、帳號和私人資料沒有進入 Git 或日誌。
  • 升級、停止和恢復都有明確動作。

如果仍無法解釋結果如何產生,就繼續把 CAD Skills 保持在測試環境,不要擴大權限或取代現有穩定流程。