Communitygithub.com

shusain/room-first-building-study

從房間程式開始設計概念建築。適用於附尺寸的 SVG 配置選項、可編輯的分階段 Blender 研究,以及跨建築類型的模型衍生材料估算。重複使用幾何、間距和組裝輔助工具,並搭配專屬專案的配方。

room-first-building-study 是什麼?

這項技能支援以「房間優先」的工作流程來設計概念建築,適用於住宅、商業、工業、市政等各類建築。使用者從空間程式和相互關係出發,推導出建築足跡、共享牆面及開口位置,並可依設計階段選擇不同的產出成果,例如 SVG 配置圖、Blender 階段性研究模型,以及材料數量估算表。該技能內建可重複使用的幾何、間距與組裝輔助函式庫,並附有住宅範例配方,讓設計師能快速起步。技能支援多種構造系統(如木構、鋼構等),並確保模型在 Blender 中保持可編輯性,同時維護元件 ID 的穩定性。此外,它嚴格遵循正確性檢查,包括功能尺寸、動線連接、門扇擺放空間及垂直開口對齊等,並保留佈局失敗的記錄,防止使用未經審查的備用方案。整個流程透過 Python 腳本(如 `plan.py`、`build_blender.py`)在背景的 Blender 5 環境中執行,輸出的檔案儲存於技能目錄之外,不干擾使用中的 Blender 會話。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shusain/ai-agent-skills/tree/HEAD/room-first-building-study

在你喜歡的 AI 中提問

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

說明文件

房間優先建築研究

從空間及其協作方式開始。根據該佈局推導出足跡、共享牆壁和開口。此工作流程適用於住宅、商業、工業、市政或其他建築。根據要求的階段選擇可交付成果。

規劃新建築

閱讀 planning.md。根據概要確定用途、樓層數、命名空間、明確尺寸、設備/傢俱、動線、出入口、服務路線和場地限制。為該專案撰寫佈局和檢查。當佈局仍在選擇中時,顯示可比較的 SVG 選項。當已有已審查的選項時,從該選項繼續進行。

對於直線型平面圖,使用可重複使用的矩形、拓撲和間距輔助工具。為其他形狀選擇適當的幾何表示法和檢查。內附的房屋配方是範例。從其自身的空間程式和組裝開始新的設計。

選擇構造系統

將專案的構造系統和單位標準帶入建模。對於木構架,使用 framing.md 和 building_study.framing.profile 以獲得實際的美制/英制或公制規格和間距。繼承已陳述的偏好。如果標準影響設計且尚不明確,在開發房間程式時澄清一次。僅顯示單位選擇不會改變庫存尺寸。

對於其他系統,宣告適用的組裝材料、截面尺寸和間距/網格輸入。將這些輸入與原生模型和材料估算一起保存。將其視為示意設計輸入。結構工程和法規遵循是獨立的任務。

建模、驗證與測量

  • 建模已審查的平面圖: 使用 blender.md。為相關的樓層、結構、屋頂、開口和裝修撰寫專屬的 Blender 配方。保持模型可編輯,並使用穩定的元件 ID 分階段組裝。當詳細網格超出範圍時,協調服務預留。
  • 數量或成本: 使用 materials.md。盤點原始構造物件,為專案定義類別和測量方法,分離採購津貼,並使用明確的日期費率。
  • 重現範例: 使用 commands.md。房屋 CLI 包含三個編排的佈局和一個已審查的家庭翼 Blender 配方。十二個佈局的備用方案是一個單獨的庫存平面圖生成器。

保持這些不變量

  1. 使用共享的座標基準,並一次性轉換為 Blender 公尺。內附的 SVG 合約使用整數毫米的房間基準點。在需要時保持精確的亞毫米木構架轉換。從房間聯合推導出足跡,並為共享牆壁和託管開口指定單一擁有者。
  2. 從審查過的來源讀取語義幾何和開口。將來源哈希值與原生模型一起保存,並拒絕過時或不支援的編輯。
  3. 檢查可用尺寸、功能配合、連通的動線、雙側門墊和完整擺放。在適用時檢查垂直開口對齊和淨空高度。在儲存的模型中驗證實際的裝置和設備幾何,並說明哪些檢查是示意性或保守的。
  4. 對完成的建築和施工階段重複使用相同的來源組件。從材料數量中排除展示用副本。
  5. 將不成功的佈局保留為失敗嘗試。僅在選定時使用備用佈局,並在修復後重新檢查覆蓋範圍、識別和存取。

包含的工具

scripts/building_study/ 包含共享的幾何、間距和 Blender 輔助工具,以及家庭翼的實作。scripts/plan.py 公開了庫存配方並驗證其支援的語義 SVG 架構。scripts/build_blender.py、verify_blender.py 和 takeoff_blender.py 在單獨的背景 Blender 行程中重現範例。將生成的檔案寫入技能外部,並保持活躍的 Blender 會話不變。

Blender 5 及其內建的 Python 可以執行核心工具。只有選用的 compose_review.py 使用 Pillow 來產生附標題的 GIF 和樓層配對。

交付來源身份、實際檢查、審查限制和剩餘的設計決策。遵循目標專案的工作流程進行採用。

相關技能