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)。如果找到此類專案,請按其原樣處理,並提議一次性地將檔案移入此結構。未經詢問,請勿移動任何內容。
第一階段:撰寫規格
- 選取模型的
<name>。對於新模型,請檢查models/<name>/是否尚不存在,如果不存在,則建立該資料夾及其specs/子資料夾。 - 從系統時鐘獲取時間戳記(例如
date +%Y-%m-%d-%H%M%S),而不是自行編造一個。 - 使用 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 並遵循以下步驟:
- 與使用者討論平面圖,使用上述提問規則:樓層、佔地面積、房間、相鄰關係、樓梯、門窗。
- 為每個樓層繪製向量平面圖。 撰寫
plans/layout.json,並使用隨附的 scripts/draw_plans.py 腳本生成plans/floor-<id>.svg。 - 與使用者一起審閱平面圖,並根據需要進行修改,直到使用者核准。在決定中記錄該核准。
核准的 layout.json 是模型牆壁、開口、房間和樓梯的唯一事實來源。對於非建築物,請跳過此階段。
第四階段:建模
將結果儲存為模型資料夾中的 <name>.blend(Blender)或 <name>.FCStd(FreeCAD)。如果是遊戲或網頁資產,請同時將其匯出到原始檔旁邊(請參閱匯出至引擎)。
選擇工具
檢查已配置了哪些 MCP 伺服器:查看您的可用工具中是否有 Blender 或 FreeCAD MCP 工具(名稱通常包含 blender 或 freecad)。
- 記住的選擇: 如果專案根目錄中存在
.3d-builder.json,請使用其中的 `