Community程式設計與開發github.com

3D 建構師

透過規格驅動的方式,在 Blender 或 FreeCAD 中創建和編輯 3D 模型。所有與單一模型相關的內容都保存在 models/<name>/ 資料夾中,包含規格檔案、問題記錄、決策與假設,以及最後生成的模型檔案。

3D 建構師 是什麼?

這個技能提供了一個結構化的工作流程,用於在 Blender 或 FreeCAD 中創建和編輯 3D 模型。它強調在實際建模之前,先撰寫完整的規格說明、釐清模糊的設計需求,並記錄所有決策與假設。這種方法能有效減少因尺寸或設計意圖不明確而導致的反覆修改。它支援 Blender 和 FreeCAD 的 MCP 伺服器,若無法使用 MCP,也能自動生成並執行 Python 腳本作為備援方案。對於建築物相關的模型,它還會引導使用者規劃樓層平面圖,並產生 SVG 圖表供審核。此技能特別適合需要精準尺寸的功能性零件、遊戲或網頁資產,以及那些使用者可能未明確提及「3D」但實際需要立體模型的場景(例如「幫我設計一個路由器壁掛架」)。

相容平台~Claude Code~Codex CLI~Cursor
Part ofMobile
npx skills add https://github.com/thanikc/3d-builder/tree/HEAD/skills/3d-builder

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

3D 建構師 是做什麼的?

不要猜測 3D 模型。先寫下要建構的內容,與使用者釐清任何模糊之處,記錄每一個假設,然後才開始建模。一個基於猜測尺寸建構的模型會被反覆修正;而規格檔案能在這些猜測變成幾何形狀之前就將其捕捉。

工作流程包含以下階段,且順序固定:規格 → 問題 → 平面圖(僅限建築物) → 模型。在規格檔案建立且問題釐清之前,不要開啟 Blender 或 FreeCAD,也不要撰寫建模程式碼。對於建築物,使用者還必須先核准平面圖。

專案配置

一個專案可以容納多個模型,因此屬於單一模型的所有內容都存放在其專屬的資料夾中:

models/
  <name>/
    specs/
      <yyyy-mm-dd-hhmmss>-<request>.md   # 每個請求一個規格檔案
    plans/                               # 僅限建築物
      layout.json
      floor-<id>.svg
    <name>.blend | <name>.FCStd          # 模型檔案
    <name>.py                            # 僅為腳本備援方案
    <name>.glb | <name>.fbx              # 僅為遊戲/網頁匯出檔
.3d-builder.json                         # 記錄工具選擇,適用於整個專案

<name> 是物件簡短的 kebab-case 名稱(例如 phone-holder, router-wall-mount)。它用作資料夾和模型檔案的名稱。除非另有說明,以下所有路徑都是相對於 models/<name>/。

較舊的專案可能仍使用先前的扁平配置(specs/ 和 plans/ 位於專案根目錄,models/<name>.blend)。如果找到此類專案,請按其原樣處理,並提議一次性地將檔案移入此結構。未經詢問,請勿移動任何內容。

第一階段:撰寫規格

  1. 選取模型的 <name>。對於新模型,請檢查 models/<name>/ 是否尚不存在,如果不存在,則建立該資料夾及其 specs/ 子資料夾。
  2. 從系統時鐘獲取時間戳記(例如 date +%Y-%m-%d-%H%M%S),而不是自行編造一個。
  3. 使用 references/spec-template.md 中的範本建立 specs/<yyyy-mm-dd-hhmmss>-<request>.md。<request> 是此請求的簡短 kebab-case 標籤:對於新模型使用 initial,對於編輯則使用變更內容(例如 thicker-hook, move-kitchen-wall)。

填寫請求中已陳述的內容,然後列出未決問題:所有會影響幾何形狀但尚未指定的項目。典型的未決問題包括:

  • 整體尺寸和單位,以及哪些尺寸是固定的,哪些是自由的
  • 與真實物體的配合和間隙(一個 60 公釐的手機需要一個略寬於 60 公釐的槽;寬多少?)
  • 壁厚、圓角/倒角、孔洞尺寸、螺絲類型
  • 安裝方式、方向、負載
  • 用途和製造方式(3D 列印 → 懸垂、最小壁厚、平坦底部;CNC;僅渲染;遊戲/網頁資產)
  • 對於遊戲/網頁資產:目標引擎、多邊形預算、引擎單位中的比例、樞軸位置、UV 和紋理 vs. 純色、LOD、碰撞網格
  • 細節層級、材質(Blender)、參數化需求(FreeCAD)
  • 對於建築物:樓層、佔地面積、房間及其大小、樓梯、門窗。這些將在第三階段透過平面圖確定,因此在此處將它們列出,而非在此詳細說明。

編輯現有模型: 首先在 models/ 中找到物件的資料夾。為此變更撰寫一個新的規格檔案(每個請求都有自己的檔案,以便歷史記錄保持清晰),將其連結到先前的規格,並說明哪些部分會變更,哪些部分必須保持不變。在編輯之前,請讀取現有模型(透過 MCP,或透過建構它的腳本),以便編輯從實際存在的內容開始。對於帶有 plans/ 資料夾的建築物,佈局變更應先通過平面圖(第三階段,「編輯建築物」)。

第二階段:釐清問題

如果請求遺留了未決問題,請在建模之前提問。使用者知道您無法推斷的事情(實際的手機寬度、牆壁螺絲的位置),現在問一個問題可以節省後續的重建工作。

規則:

  • 一次只問一個問題。 等待回答後再問下一個。按照問題對幾何影響程度的大小排序:先問整體尺寸和用途,最後問細節。
  • 盡可能問是/否問題。 「電纜槽應該置中嗎?」優於「電纜槽應該放在哪裡?」。
  • 否則使用選擇題: 推薦選項放在第一位並標記「(建議)」,然後是其他選項,最後是自由文字輸入選項。如果有的話,請使用代理程式的提問工具(例如 AskUserQuestion);它通常會為您添加自由文字選項。
  • 每批 5 個問題。 每問完 5 個問題,就詢問是否要繼續問多達 5 個問題,並大致說明還剩多少個未決問題。如果使用者說不要,就停止提問。
  • 不要問與此模型無關的事情,也不要問使用者已經說過的事情。
  • 立即將每個答案記錄在規格的決定部分,以便規格始終保持最新。

當沒有任何重要的不明確事項,或者使用者停止回答時,停止提問。對於每個仍然存在的未決問題,自行決定,選擇符合所述用途的合理預設值,並在假設中附上一行原因。使用者應該能夠閱讀規格並看到為他們做出的每個選擇。

如果請求已經完全指定,請跳過提問階段,並用一行話說明。

第三階段:平面圖(僅限建築物)

如果模型是建築物或包含房間,請先在紙面上確定佈局。閱讀 references/floorplans.md 並遵循以下步驟:

  1. 與使用者討論平面圖,使用上述提問規則:樓層、佔地面積、房間、相鄰關係、樓梯、門窗。
  2. 為每個樓層繪製向量平面圖。 撰寫 plans/layout.json,並使用隨附的 scripts/draw_plans.py 腳本生成 plans/floor-<id>.svg。
  3. 與使用者一起審閱平面圖,並根據需要進行修改,直到使用者核准。在決定中記錄該核准。

核准的 layout.json 是模型牆壁、開口、房間和樓梯的唯一事實來源。對於非建築物,請跳過此階段。

第四階段:建模

將結果儲存為模型資料夾中的 <name>.blend(Blender)或 <name>.FCStd(FreeCAD)。如果是遊戲或網頁資產,請同時將其匯出到原始檔旁邊(請參閱匯出至引擎)。

選擇工具

檢查已配置了哪些 MCP 伺服器:查看您的可用工具中是否有 Blender 或 FreeCAD MCP 工具(名稱通常包含 blender 或 freecad)。

  1. 記住的選擇: 如果專案根目錄中存在 .3d-builder.json,請使用其中的 `

相關技能