Domain 索引（72 個 SOP）· BIM

SECTION 02 · COMPLIANCE

法規與 compliance SOP（11）

建築技術規則、消防法、無障礙設施規範的本地化 SOP。標 ★ 為含抽屜摘要——點開可看完整公式與例外處理。

fire-rating-check.md

防火時效檢核——構件耐燃、防火區劃、防火構造分類。

fire rating防火耐燃 ↔ /fire-safety-check

corridor-analysis-protocol.md

走廊寬度、逃生路徑、通道淨寬檢核協議。

corridorescape route逃生 ↔ /fire-safety-check

exterior-wall-opening-check.md

外牆開口距鄰地線距離（§110），防火必要區的判定。

外牆開口鄰地距離§110 ↔ /fire-safety-check

floor-area-review.md

容積率、樓地板面積計算、送審面積核對。

FAR容積送審 ↔ /building-compliance

parking-clearance-check.md

停車位淨高 ≥ 210cm、車道寬度、機車位 clearance。

停車clearance>210cm ↔ /parking-check

parking-space-review.md

停車位數量分類（法定、無障礙、增設、機車等 8 類）。

停車位數量parking count ↔ /parking-check

stair-compliance-check.md

樓梯級高、級深、淨寬、淨高（建技 §33）法規檢核。

樓梯法規stair compliance級高級深 ↔ /qa-review

wall-check.md

外牆 Exterior / Interior Side 方向檢核，避免飾面位置與容積計算錯誤。

wall orientation內外方向 ↔ /wall-orientation-check

smoke-detector-check.md

消防偵煙探測器設置法規檢討——出風口距離、壁樑距、天花板貼附、區格涵蓋、探測面積五項規定檢核。

偵煙探測器smoke detector探測面積 ↔ /smoke-detector-check

SECTION 03 · MODEL WORKFLOW

模型操作與圖面 workflow（36）

非法規驅動的日常 BIM 作業 SOP——查詢、上色、標註、出圖、視圖管理、立面/帷幕牆設計。

element-query-workflow.md

三階段查詢協議：探索 → 對齊 → 擷取。

查詢filterfind elements ↔ /element-query

element-coloring-workflow.md

依參數值對 Revit 元素進行顏色標記與視覺化。

上色color codehighlight ↔ /element-coloring

unjoin-geometry-workflow.md

批次解除 Revit 幾何接合（Join Geometry）——BoundingBox 外擴搜尋、跑兩次驗證、session-scoped 還原限制。

解除接合unjoin geometry白模 ↔ /unjoin-geometry

auto-dimension-workflow.md

Ray-Casting / BoundingBox 自動標註房間、走廊、MEP 設備。

標註ray cast淨寬 ↔ /auto-dimension

detail-component-sync.md

2D 詳圖元件編號（AE-numbering）與圖紙號碼同步。

詳圖圖頭標頭 ↔ /detail-component-sync

dedup-detail-elements-workflow.md

視圖內重複 detail element 清理——同 Category+Type+位置量化判定重複，優先保留 Detail Group 內副本，dryRun 預覽兩階段流程。

重複詳圖dedup detail清理重複 ↔ /dedup-detail-elements

dependent-view-crop-workflow.md

依網格線批次建立從屬視圖與裁剪範圍。

從屬視圖grid crop分區出圖 ↔ /dependent-view-crop

sheet-viewport-management.md

圖紙、視埠、titleblock 批次建立、重新編號、衝突修正。

圖紙titleblockviewport ↔ /sheet-management

stair-hidden-line-workflow.md

剖面中為被側板遮擋的樓梯梯級繪製虛線詳圖線。

stair hidden line虛線剖面 ↔ /stair-hidden-line

room-numbering-workflow.md

房間自動編號規則（樓層 × 區域 × 序號）。

room numbering房間編號 ↔ /element-query

room-height-limit.md

Room 上限高度（Upper Limit / Limit Offset）SOP——四參數語意、房高計算公式、批次設定的 Group/Area=0 常見誤區。

房間高度room heightupper limit ↔ /batch-room-height

room-surface-area-review.md

房間表面積、粉刷 finish 面積核對。

房間表面積粉刷finish ↔ /qa-review

room-boundary.md

房間邊界判定與例外處理（陽台、夾層、樓梯間）。

room boundary房間邊界 ↔ /building-compliance

curtain-wall-pattern.md

帷幕牆面板配置模式（網頁預覽 → 套用 Revit）。

curtain wallpanel layout ↔ /curtain-wall

facade-generation.md

AI 照片分析 → 立面面板五種幾何（弧形 / 斜切 / 傾斜 / 圓角 / 平面）。

facadeAI designDirectShape ↔ /facade-generation

parking-auto-numbering.md

停車位自動編號規則（區域 + 連續序號）。

parking numbering停車自動編號 ↔ /parking-check

section-datum-adjustment.md

剖面視圖網格線 / 樓層線 2D 範圍與氣泡自動排版（Crop Box + 字串長度自適應）。

section datumcrop box出圖排版 ↔ adjust_section_datums

section-auto-numbering.md

剖面依幾何座標排帶式排序 + 兩階段防衝突命名（rename_view）。

section numbering剖面編號rename view ↔ rename_view

floor-slope-analysis.md

樓板頂面排水坡度分析（Solid→PlanarFace 法向量算坡度，批次回寫參數）。

floor slope排水坡度洩水 ↔ analyze_floor_slopes

door-window-legend-workflow.md

門窗圖例（legend）自動建立——收集已放置門窗類型、依 Type Mark 自然排序、產生圖例視圖。

門窗圖例door legendwindow legend

dwg-column-import.md

從 CAD/DWG 圖層批次建立結構柱／建築柱：單位/放樣健檢 → 選模式 → 批次建模。三模式（自動建型別／既有族群尺寸／柱號對應 textLayerName）依情境選用，分步協作。

dwg 建柱cad 柱圖層建柱柱號對應 ↔ /dwg-column-import

dwg-beam-import.md

從 CAD/DWG 圖層批次建立結構樑：掃描圖層 → 確認批次與模式 → 放樣健檢 → 批次建樑。支援全正交與含非正交（斜樑）圖說；兩波處理（正交優先→斜樑點到線段距離配對），分批大樑／次樑／地樑。

dwg 建樑cad 樑樑翻模大樑次樑 ↔ /dwg-beam-import

finish-legend-creation.md

房間飾面圖例（finish legend）建立——彙整地坪／牆面／天花飾面代碼成圖例。

飾面圖例finish legend

revit-partition-takeoff.md

隔間牆數量計算（partition takeoff）——依類型／樓層彙整隔間面積與長度。

隔間數量partition takeoff數量計算

family-inventory-cleanup.md

族群盤點與清整閉環——雙軸盤點（載入 vs 放置）、參數簽章比對、purge 未使用／merge 重複／rename。

族群整理類型盤點未使用類型重複類型purge ↔ /family-inventory-cleanup

detect-range-box.md

大專案範圍框／裁剪框無痛調整 SOP（pyRevit ExpandCropBox）。

範圍框裁剪框ExpandCropBox ↔ /dependent-view-crop

view-link-cleanup-workflow.md

關閉連結模型基準元件（樓層線／網格線／參考平面）維持圖面整潔；技術結案負面結果（對應上游 issue #72）。

視圖連結連結模型基準圖面整潔

curtain-wall-elevation-workflow.md

帷幕牆外立面視圖生成——用原生 ElevationMarker 為每道 curtain wall 建外側 elevation，套「帷幕立面」View Template、回報 skipped 原因。

帷幕立面curtain wall elevationElevationMarker ↔ /curtain-wall

finish-schedule-governance.md

粉刷明細表材料代碼治理——F/B/W/C 代碼盤點、跳號重排、批次回寫房間粉刷參數、同步 AE-材料版，並用 CSV 反查驗證。

粉刷明細表finish schedule材料代碼 ↔ /finish-schedule-governance

quantity-takeoff-excel.md

Revit 數量計算 Excel 共通方法——以房間邊界、實體宿主、淨高與材料代碼建立可追溯算式（輕隔間／踢腳／內牆粉刷／空間表）。

數量計算quantity takeoffExcel房間邊界 ↔ /quantity-takeoff-excel

scaffold-takeoff.md

施工架算量——室外以外牆周長×高度、室內以房間周長×高度計算，含框式施工架與防護設施規則。

施工架scaffold周長算量 ↔ /scaffold-takeoff

tall-partition-index-workflow.md

輕隔間高牆（>6m）結構回饋索引圖——TYPE 牆分析、房間排除、與細節一起複製視圖，藍色房間填滿＋紅色牆線標示。

高牆tall partition索引圖結構檢討 ↔ /tall-partition-index

threshold-opening-takeoff.md

門檻開口統計——依房間關聯統計門/窗數量，套用房間與類型排除規則，用於門檻與開口算量。

門檻threshold開口統計門窗數量 ↔ /threshold-opening-takeoff

matchline-automation.md

銜接線（matchline）自動化標註——偵測相鄰從屬視圖 CropBox 邊界，建立銜接線、相鄰圖紙號碼文字並清理舊標註。

銜接線matchline從屬視圖 ↔ /dependent-view-crop

rc-filled-region-workflow.md

RC 結構剖切面填滿區域自動化——批次收集牆／柱／樓版／樑剖切面建深灰 FilledRegion，以幾何指紋支援智慧更新。

RC 填滿FilledRegion剖切面智慧更新

viewport-type-scale-sync.md

依圖紙視埠已放置視圖的比例同步視埠標題類型（平面／立面／剖面），含圖例排除與 dry-run 驗證。

viewport視埠類型視圖比例dry-run ↔ /sheet-management

SECTION 04 · OPS / QA / AUTHORING

維運、QA 與 authoring 標準（10）

不是 BIM 作業本身，而是專案治理層——讓專案在多人多 AI client 協作時不會走樣。

qa-checklist.md

圖紙、詳圖、視圖、參數、MCP 系統健康度的 6 階段檢核。

QAverification一致性 ↔ /qa-review

path-maintenance-qa.md

目錄重構、檔案搬移的 QA 流程，避免引用失效。

路徑QC目錄重構 ↔ /claude-md-sync

session-context-guard.md

當前視圖、樓層、連結模型 context 守護——避免跨樓層誤操作。

context guard視圖連結模型 ↔ /element-query

tool-capability-boundary.md

工具能做什麼 / 不能做什麼的邊界宣告——避免 LM 補虛構能力。

工具能力邊界capability ↔ 第二憲法

frontmatter-standard.md

YAML frontmatter 欄位規範與 qaqc Phase 6 lint 規則。

frontmatterYAML 標頭 ↔ Contributor Template

lessons.md

開發過程踩雷紀錄、避坑備忘。每次 /lessons 後追加。

lessons learned避坑 ↔ 全 Skill 都看

core-reload-boundary.md

Loader/Core 熱重載邊界與效益（opt-in 進階開發者知識）。

熱重載core reloadCoreRuntime ↔ /core-reload-dev

domain-flow-visualization.md

domain 流程圖像化——mermaid 流程健檢（迴圈／死路／缺口）。

流程圖像化mermaid流程健檢 ↔ /domain-diagram

local-update-workflow.md

本機環境更新部署流程（環境專屬）——pull 後重新編譯 MCP Server、SDK 相容處理、手動部署 DLL 至 Revit Addins。

本機更新local update環境專屬

SECTION 05 · MEP + STRUCTURE

MEP、構件與穿梁（14）

機電與結構的交界面——碰撞、穿梁、機械構件、跨領域出圖。MEP 與結構的交界面 SOP 群組（穿梁套管 PR #68 已收編 main，v2 完整線於 feature/seven777-beam-penetration-v2 續行）。

beam-penetration-base 與其 RC／SC／SRC 三個細分檔各自獨立存在於 domain/*.md，均計入下方 SOP 總數。

beam-penetration-rc.md

RC 混凝土梁穿孔——Zone A 禁開、Zone B 限制、Zone C 許可。

RC 梁Zone A/B/C混凝土 ↔ base

beam-penetration-sc.md

SC 鋼梁穿孔——腹板開孔（web opening）、flange 限制。

SC 鋼梁web openingflange ↔ base

beam-penetration-src.md

SRC 鋼骨混凝土梁——composite beam internal steel 穿孔規則。

SRC 梁鋼骨混凝土composite ↔ base

mep-extension-guide.md

MEP 工具擴展研究指南——pyRevit 模式參考。

MEPpyRevit機電 ↔ 開發層

mechanical-part-doc.md

機械出圖 assembly、BIP、視圖生成、比例計算。

mechanicalassemblyBIP ↔ /sheet-management

pdf-export-comparison.md

PDFExportOptions 各模式比較——送審 / 文管 / 加工發包用途。

PDF出圖送審DCC ↔ /sheet-management

revit-fill-pattern-conversion.md

填充樣式（fill pattern）轉換規則。

fill pattern填充圖案 ↔ /element-coloring

ifc-structural-sync.md

IFC 匯入結構框架同步——對齊 imported structural framing 與原生結構構件。

IFCstructural sync結構框架

beam-penetration-algorithm.md

穿梁套管幾何演算法——實體投影降維、幾何接合與實體邊緣判定。

穿梁演算法實體投影邊緣判定 ↔ /detect-clashes

sleeve-classification-protocol.md

MEP 套管身分識別協議——穿梁／穿牆／穿板判定。

套管分類穿梁穿牆穿板sleeve ↔ /detect-clashes

beam-slab-alignment.md

既有結構樑降樑貼齊樓板底——寫入起始／結束樓層偏移，依主要覆蓋樓板選定目標樓板，支援 dry-run 與全棟批次調整。

降樑beam slab alignment樓層偏移樓板底 ↔ ifc-structural-sync

ifc-structural-native-sync.md

IFC 結構模型轉 Revit 原生 StructuralFraming／StructuralColumns 同步——梁柱建立、b/h 參數、貼樓板底、replaceExisting 重建與驗證。

IFCstructural sync原生梁柱replaceExisting ↔ /ifc-structural-sync

SECTION 06 · EXTERNAL REFERENCES

外部規範庫（1）

非本專案產出的 SOP，而是引用外部規範本文。放在 domain/references/ 子目錄。

references/building-code-tw.md

台灣建築技術規則條號索引——容積率、防火構造、走廊寬度、樓梯寬度、無障礙等對應條號速查。

building code法規條號建築技術規則 ↔ 全法規 Skill 都引用

SECTION 07 · CONTRIBUTION

新增 Domain 的順序

WHY

Domain 是方法的單一來源。法規修訂只改一份 SOP，所有引用它的 Skill 自動跟上。

HOW

先寫 domain/*.md，再決定要不要建 Skill（不是每個 domain 都要 Skill）。最後跑 /claude-md-sync 驗證雙向一致。

TECHNIQUE

Knowledge / Orchestration Separation · Single Source of Truth · No Skill Inflation

CHECKLIST

新增 compliance 主題 → 先建 domain/*.md，含 frontmatter
需要 AI workflow 編排再建/更新 Skill
更新 CLAUDE.md 觸發表（38 行的那張）
更新此頁卡片（含 trigger + 反查 Skill）
跑 /claude-md-sync 與 /qaqc 驗收

→ 完整貢獻範本（含 6 步驟停車場淨高範例）

本 SOP 解決什麼

建技規則 §41：居室採光面積 ≥ 該居室樓地板面積的 1/8（≈ 12.5%）。但 tool 回的 raw data 不直接給 PASS / FAIL——必須套 75cm 台度扣除公式 + 納入外牆門開口（含玻璃部分）。

核心公式

有效採光面積 = Σ（窗開口面積）+ Σ（外牆門有效面積）

外牆門有效高度 = HeadHeight − 750mm （扣 75cm 台度基準）

採光比 = 有效採光面積 / 居室樓地板面積，必須 ≥ 12.5%

常見錯誤（違規範例）

2026-04-23 違規案例

❌ 排除所有外牆門（誤以為門不算採光） → Room 203 被低估 1.38 m²
❌ 未套 75cm 台度扣除 → 結果偏高
❌ 用 LM prior 補計算 → 違反第二憲法 Domain Method Compliance

正確流程

呼叫 get_room_daylight_info(level='LX') 取得房間 + 開口 raw data
讀 domain/daylight-area-check.md 完整 SOP
對每個外牆開口（含門）套 Effective Height = HeadHeight − 750mm（若 SillHeight < 750mm）
計算採光比、輸出 PASS / FAIL + 證據

深度

Constitution第二憲法 Domain Method Compliance
Filedomain/daylight-area-check.md

本 SOP 解決什麼

建技 §101 + 消防 §188：居室排煙窗在天花板下 80cm 範圍內的有效開口面積，必須 ≥ 該居室樓地板面積的 2%（或機械排煙替代）。

三個判定

無窗居室判定：完全無對外開口 → 強制機械排煙
無開口樓層判定：整層平面對外開口不足 → 需檢討避難動線
有效面積計算：僅天花下 80cm 內的窗計入，其下方部分忽略

常見錯誤

tool 預設行為踩雷

❌ createAnnotatedViews=true 預設會建 80+ 視圖污染專案
✅ 5/18 demo 後改預設 false（commit 4975ceb）

正確流程

呼叫 check_smoke_exhaust_windows(level='LX', createAnnotatedViews=false)
讀 SOP 確認天花下 80cm 規則 + 機械排煙替代條件
若 FAIL → 套 A/B/C/D 框架

深度

Skill/smoke-exhaust
SpectrumA/B/C/D 套例 2

本 SOP 解決什麼

結構工程容許梁穿孔（套管穿梁），但有嚴格位置與大小限制避免削弱抗剪能力。三種材料各有規則：

RC（混凝土）：Zone A 禁開 / Zone B 限制 / Zone C 許可
SC（鋼梁）：腹板 web opening 規則、flange 嚴禁
SRC（鋼骨混凝土）：依 composite beam internal steel 規則

本 base SOP 共用部分

判定梁類型（RC / SC / SRC）
分派到對應細項 SOP（RC / SC / SRC）
共用輸出格式（穿孔位置 + 大小 + Zone 判定 + 建議）

當前分支重點

PR #68 已收編進 main（2026-07-02，analyze_beam_penetration + scan_penetrated_beams_in_view 上線）；wave-2 完整線於 feature/seven777-beam-penetration-v2 續行（visualize/SRC mapping/SC-SRC 草稿）。

細分檔

Filedomain/beam-penetration-rc.md
Filedomain/beam-penetration-sc.md
Filedomain/beam-penetration-src.md
Hands-on穿梁套管收編 hands-on（2026-07）

本 SOP 解決什麼

MEP 管線 × 結構（CSA = Civil / Structural / Architectural）碰撞偵測。傳統 Navisworks 用 Solid-to-Solid 計算量大，本 SOP 採 Curve-to-Solid 策略加速（把管線視為 curve）。

三階段

偵測：對指定 view / level 跑 detect_clashes
視覺化：自動 colorize_clashes 染紅／橘／黃三級嚴重度
匯出：export_clash_report 產出可送業主的 PDF / Excel

觸發場景

每個階段完成點（P7）後跑一次——對應業界 70% 返工可避免的統計
圖紙快出前必跑——避免「圖出後才發現碰撞」

深度

Skill/detect-clashes
Evidence70% 返工可避免

本 SOP 解決什麼

當新貢獻者想新增功能時——該寫 Domain？該寫 Skill？該加 Tool？ 沒有 SOP 會導致「每個小需求都建一個 Skill」造成 metadata 膨脹。

三選一決策樹

只有方法 / 法規條文 → 寫 domain/*.md，不建 Skill
有跨多 tool 的編排價值 + 觸發頻率高 → 才建 Skill
沒有對應 tool → 先在 issue tracker 開 RFC，再評估加 MCP tool

Skill 入門檻

協調 ≥ 2 個 tool（單 tool 不必開 Skill）
觸發關鍵字高頻（冷門關鍵字停在 Domain）
引用既有 Domain（不寫新知識，寫新編排）

反例

不該升 Skill 的常見誤判

❌ 把單一 tool 的「使用範例」當 Skill
❌ 把複製貼上的 SOP 包成 Skill body（應該引用 Domain）
❌ 為了 demo 漂亮而建 Skill

深度

TemplateContributor Template（含 6 步驟範例）
IndexSkills 索引（50）

Domain · 知識層
方法寫一次，多個 Skill 共用

Tool / Domain / Skill 三層關係

Tool（166）

Domain（72）

Skill（50）

法規與 compliance SOP（11）

模型操作與圖面 workflow（36）

維運、QA 與 authoring 標準（10）

MEP、構件與穿梁（14）

外部規範庫（1）

新增 Domain 的順序

本 SOP 解決什麼

核心公式

常見錯誤（違規範例）

正確流程

本 SOP 解決什麼

三個判定

常見錯誤

正確流程

本 SOP 解決什麼

本 base SOP 共用部分

當前分支重點

本 SOP 解決什麼

三階段

觸發場景

本 SOP 解決什麼

三選一決策樹

Skill 入門檻

反例