SKILLS INDEX 50 個

Skills · 編排層
何時觸發 / 什麼順序

Skills 是編排（orchestration），不是知識本身。一個 Skill 規定「什麼關鍵字觸發 / 呼叫哪些工具 / 套用哪個 Domain SOP」。Skill metadata 永遠常駐於 AI Client context；body 與 Domain 被引用時才載入。本頁列 50 個 Skill 的描述、觸發關鍵字與對應 Domain。

FRAME · 三層架構

Skill / Domain / Tool 三者分工

Skill（編排）

何時觸發 + 呼叫哪些 tool + 什麼順序。50 個。

Domain（知識）

法規條文、SOP、計算公式。72 個。被 Skill 引用。

Tool（執行）

原子操作（query / create / modify）。166 個 MCP tools。

「不要把每個 Domain 都升級成 Skill」——這是本專案的核心架構原則。詳見 22 命題。

完整三層定義見 三層架構 V2。

CATALOG · 50 個 Skill

50 個 Skill · 依用途分組

A · 法規檢核（6 個）
/fire-safety-check
A · 法規檢核
消防安全檢討：防火時效視覺化、走廊防火分析、外牆開口距離檢討（建技 §49、§110）。
防火fire rating走廊外牆開口鄰地距離 → fire-rating-check → corridor-analysis-protocol → exterior-wall-opening-check
/smoke-exhaust
A · 法規檢核
排煙窗法規檢討：無窗居室判定、無開口樓層判定、排煙有效面積計算、剖面標註、Excel 報告匯出（建技 §101、消防 §188）。
排煙無窗居室無開口樓層smoke exhaust天花板下80cm → smoke-exhaust-review
/building-compliance
A · 法規檢核
建築法規檢討：居室採光比（§41）、容積率與樓地板面積計算、停車位尺寸與數量檢核。
採光daylight容積率FAR樓地板面積送審 → daylight-area-check → floor-area-review
/parking-check
A · 法規檢核
停車場檢討：停車位淨空高度檢查（>210cm）與停車位數量分類統計（法定、無障礙、增設等八類）。
停車場停車位parkingclearance機車位 → parking-clearance-check → parking-space-review
/wall-orientation-check
A · 法規檢核
牆壁內外方向檢查：檢測外牆的 Exterior/Interior Side 是否正確，錯誤方向會影響飾面位置與容積計算。
牆壁方向內外側wall orientationExterior Side → wall-check
/smoke-detector-check
A · 法規檢核
消防偵煙探測器設置法規檢討：出風口距離、壁樑距、天花板貼附、區格涵蓋、探測面積五項規定檢核（工具：analyze_smoke_detectors、visualize_detector_results）。
偵煙探測器smoke detector check探測面積消防探測器 → smoke-detector-check
B · 設計協作（4 個）
/curtain-wall
B · 設計協作
帷幕牆面板配置：設計帷幕牆面板排列模式並透過網頁預覽確認後套用到 Revit。
帷幕牆curtain wall面板panel pattern玻璃面板 → curtain-wall-pattern
/facade-generation
B · 設計協作
立面面板生成：透過 AI 照片分析設計立面面板，套用到 Revit 牆面。支援弧形面板、斜切凹窗、傾斜平板、圓角開口、平面面板五種幾何。
立面facade弧形面板凹窗DirectShape → facade-generation
/element-coloring
B · 設計協作
元素上色工作流程：根據參數值對 Revit 元素進行顏色標記與視覺化。
上色color codehighlight參數上色 → element-coloring-workflow
/element-query
B · 設計協作
元素查詢與視覺化：三階段查詢協議（探索→對齊→擷取），支援依參數篩選與上色標記。
查詢篩選element queryfilterfind elements → element-query-workflow
C · 文件生產（16 個）
/auto-dimension
C · 文件生產
自動標註尺寸：使用 Ray-Casting 或 BoundingBox 方法，在平面視圖中自動建立房間、走廊、MEP 設備的尺寸標註。
標註尺寸dimension淨寬淨高 → auto-dimension-workflow
/detail-component-sync
C · 文件生產
2D 詳圖元件同步：將詳圖圖頭（AE-numbering）的編號與圖紙號碼自動同步。
詳圖同步圖頭AE-numberingdetail component → detail-component-sync
/dependent-view-crop
C · 文件生產
從屬視圖批次裁剪：依網格線為邊界，批次建立從屬視圖並設定裁剪範圍。適用於大型專案分區出圖。
從屬視圖dependent view分區出圖網格裁剪 → dependent-view-crop-workflow
/sheet-management
C · 文件生產
圖紙與視圖埠管理：批次建立圖紙、自動修正圖號衝突、語義化重新排序、依網格裁剪建立從屬視圖。
圖紙圖號titleblockrenumberviewport → sheet-viewport-management
/stair-hidden-line
C · 文件生產
剖面隱藏樓梯可視化：在剖面視圖中，自動為被側板遮擋的樓梯梯級繪製虛線詳圖線。
樓梯隱藏線stair hidden line剖面樓梯虛線 → stair-hidden-line-workflow
/wall-section-batch
C · 文件生產
牆面套管剖面批次建立：先確認命名前綴與排序方式，再依牆面套管／開孔位置批次建立平行剖面視圖並輸出摘要（工具：batch_create_wall_sections、create_parallel_section_view）。
牆面套管剖面wall section batch平行剖面批次剖面
/copy-detail-items
C · 文件生產
批次複製詳圖項目（DetailCurve、TextNote、FilledRegion、DetailComponent、Dimension）從一個來源視圖到一或多個目標視圖，支援類別過濾、XY 偏移、dryRun 預覽。
批次複製詳圖copy details to views複製標註batch copy annotations
/dedup-detail-elements
C · 文件生產
找出並刪除視圖中重複的 detail element（同 Type + 位置量化後相同），優先保留 Detail Group 內副本；dryRun 預覽 → 使用者確認 → 執行刪除的兩階段 SOP。
刪除重複詳圖dedup detail清理重複duplicate detail elements → dedup-detail-elements-workflow
/text-note-batch
C · 文件生產
在多個 DraftingView 中依文字內容搜尋 TextNote 並批次平移。適用於跨圖面統一調整法規文字、表格附註等重複出現的位置。
批次移動 TextNotemove text notes跨視圖移動文字batch text
/align-views-on-sheets
C · 文件生產
批次對齊 view 範圍 + viewport 在 sheet 上的位置：三階段流程結合 ScopeBox 綁定裁剪範圍、可選的 titleblock 對齊、viewport 錨點定位。適用於跨專案複製後對齊新 view、批次統一系列圖紙 layout、出圖前最後對齊。
對齊 view套用 scope boxalign views to scope boxposition viewports on sheettitleblock 對齊
/batch-apply-view-template
C · 文件生產
批次將指定的 ViewTemplate 套用到多個 view：支援以 sheets 或 view 名稱/ID 選取目標，可搭配 viewTypeFilter 過濾類型，並提供 dryRun 預覽與 skipIfSameTemplate 避免重複套用。
批次套用 view templateapply view template to sheetsbatch view template視圖樣版批次修改
/viewport-arrangement
C · 文件生產
視埠排列與管理：在圖紙上放置、排列、移動 DraftingView 視埠。支援自動放置（從專案查找 view 並放到圖紙）、跨圖紙移動、水平/垂直排列、邊緣對齊、負間距重疊。
排列視埠viewport arrangementalign viewportsedge-to-edgemove viewport
/scale-drafting-width
C · 文件生產
DraftingView 表格縮放：支援寬度（X 軸）和行高（Y 軸）獨立縮放，寬度以左邊緣為錨點、行高以上邊緣為錨點，將 DetailCurve 與 TextNote 座標按比例縮放。適用於 Excel 匯入後微調表格欄寬、行高。
縮放scale widthscale height表格寬度行高
/floor-plan-from-template
C · 文件生產
以指定的 FloorPlan 視圖為範本，在多個 Level 上批次建立樓層平面視圖（複製 ViewFamilyType、View Template、Phase、Phase Filter），並可選擇性將新 view 的 CropBox 對齊到指定 Detail Group（例如圖框）。適用於補齊缺漏的正式建築圖系列。
批次建立樓層平面補齊平面圖create floor plansalign cropbox 到圖框
/copy-sheets-cross-project
C · 文件生產
跨專案複製含 model views 的圖紙：Revit 原生「Insert Views from File」無法匯入含 model view 的 sheets，本 skill 用兩階段流程（讀取→確認衝突→執行）自動化重建，處理 view 四級分類、ScheduleSheetInstance 重建、Sheet custom parameters 一併複製。
跨專案複製圖紙Insert Views from Filecross-documentsource.rvt移植視圖
/excel-to-legend
C · 文件生產
將 Excel worksheet 批次匯入 Revit Drafting View，忠實還原合併儲存格、表格框線、原始 column/row 尺寸與長文字 wrap 行為，覆蓋舊 view 時自動還原所有 sheet 上的 viewport 位置。優先使用一站式 import_excel_to_drafting_views 命令。
excel 表格excel to drafting表格匯入 revit面積計算表匯入
D · 模型分析（17 個）
/detect-clashes
D · 模型分析
MEP 管線與結構（CSA）碰撞偵測，使用 Curve-to-Solid 策略進行干涉分析、視覺化與報告匯出。
碰撞clashMEP管線穿牆套管penetration → mep-csa-clash-detection
/qa-review
D · 模型分析
專案品質檢核：圖紙編號一致性、詳圖元件完整性、視圖組織、參數正確性、MCP 系統健康度。
QA品質檢查驗證一致性系統健康 → qa-checklist
/dwg-beam-import
D · 模型分析
從 CAD/DWG 圖層批次建立結構樑：掃描圖層 → 確認批次與模式 → 放樣健檢 → 批次建樑。支援全正交與含非正交（斜樑），兩波處理防呆，分批大樑／次樑／地樑。
dwg 建樑樑翻模大樑次樑beam from dwg → dwg-beam-import
/dwg-column-import
D · 模型分析
從 CAD/DWG 圖層批次建立結構柱／建築柱：單位/放樣健檢 → 選模式 → 批次建模。三模式（自動建型別／既有族群尺寸／柱號對應）依情境選用，強制斷點分步協作。
dwg 建柱cad 柱圖層建柱column from dwg柱號對應 → dwg-column-import
/family-inventory-cleanup
D · 模型分析
族群盤點與清整：雙軸盤點（載入 vs 放置）、參數簽章比對、purge 未使用／merge 重複／rename；破壞性動作前 12 項強制前置檢查。
族群整理類型盤點未使用類型重複類型purge → family-inventory-cleanup
/unjoin-geometry
D · 模型分析
批次解除 Revit 幾何接合（Join Geometry），以任一類別為中心解除與 8 大預設 target 類別的接合，適用於白模準備、幾何分析、上色前清理。
解除接合unjoin geometry白模render preparation → unjoin-geometry-workflow
/batch-room-height
D · 模型分析
批次調整房間上限高度：依房間名稱或用途分組，指定目標高度（mm）後一次套用到所有符合的 Room（Upper Limit + Limit Offset），不動樓層。
房間高度room heightupper limit批次房高 → room-height-limit
/view-category-visibility
D · 模型分析
視圖類別可見性控制：在指定視圖中隱藏或顯示整個類別（含連結模型），支援批次多視圖操作。
隱藏顯示category visibility連結模型隱藏
/batch-material
D · 模型分析
批次材質修改（複製原材質模式）：為每個 Type 的原材質建立複本，只修改複本的 Appearance diffuse color，保留 Graphics 顏色與其他屬性。適用於渲染白模（Enscape/V-Ray 看到白色，平面圖切割圖案維持原材質）。也支援復原。
材質white model批次換材質restore material
/partition-takeoff
D · 模型分析
輕隔間牆數量計算與 CSV 報表更新：以 TYPE 牆為候選，只扣除 host 可驗證的門窗開口，牆面積以 Revit 牆面積為基準，輸出可稽核算式。
輕隔間partition takeoffTYPE 牆扣除開口數量計算 → revit-partition-takeoff
/quantity-takeoff-excel
D · 模型分析
建立／檢核可稽核的 Revit 數量計算 Excel：輕隔間、踢腳、內牆粉刷、空間表、施工架，以房間邊界、host 開口證據、淨高鏈與材料代碼建立算式。
數量計算算量quantity takeoffroom perimeteropening deductions → quantity-takeoff-excel
/scaffold-takeoff
D · 模型分析
施工架數量計算：室外採人工描繪外周長、室內房間以周長×高、樓梯／電梯室內裝修以長×寬×高，含防護設施與地下室外牆防水毯周長共用規則。
施工架scaffold外部周長室內施工架周長x高 → scaffold-takeoff
/tall-partition-index
D · 模型分析
輕隔間高牆（>6m）結構回饋索引圖：analyze_tall_partition_rooms 篩 TYPE 高牆與共牆房間、複製交付視圖、藍色房間填滿＋紅色牆線標示，交付前 QA。
高牆tall partition結構回饋索引圖與細節一起複製 → tall-partition-index-workflow
/threshold-opening-takeoff
D · 模型分析
依房間關聯統計門/窗數量：任一側房間或類型命中排除規則即整樘排除，依類型備註（門編號）彙總，用於不鏽鋼門檻數量與開口計算。
門檻threshold門窗統計房間排除不鏽鋼門檻 → threshold-opening-takeoff
/room-numbering
D · 模型分析
房間重新排序編號與批次自動編號：優先 renumber_rooms_by_level，中心點由上而下、由左而右排序，dry-run → 寫入 → 驗證。
房間編號renumber rooms自動編號從 B134 開始只排 B1F → room-numbering-workflow
/ifc-structural-sync
D · 模型分析
IFC 結構同步至 Revit 原生 StructuralFraming／StructuralColumns：dry-run 檢查 b/h 與貼樓板底、replaceExisting 重建同源元素、apply 後回讀驗證。
IFC 結構sync_ifc_structural_to_nativeStructuralColumnsb/hreplaceExisting → ifc-structural-native-sync
/finish-schedule-governance
D · 模型分析
治理房間粉刷明細表與 F/B/W/C 材料代碼：盤點、跳號重排、批次回寫房間參數、同步 AE-材料版，並以外部 CSV 比對房間欄位。
粉刷明細表材料編號finish code remapAE-材料版粉刷比對 CSV → finish-schedule-governance
E · 開發運維（4 個）
/build-revit
E · 開發運維
Build the RevitMCP Revit add-in for one or all Revit versions (2022–2026) using the unified RevitMCP.csproj.
buildRelease.R{YY}Nice3point多版本 → deployment-guide
/deploy-addon
E · 開發運維
Deploy the built RevitMCP.dll to the correct Revit Add-ins folder for a specified version (Windows only).
deployAppDataDLLAddins folder → deployment-guide
/claude-md-sync
E · 開發運維
CLAUDE.md 雙向同步驗證：當合併外部 PR、Domain 升級 Skill、或 Tools 異動後，執行正向（作業→CLAUDE.md）與反向（CLAUDE.md→作業）的比對與修正迴圈。
claude.md 同步驗證一致性merge 後檢查skill 新增後 → path-maintenance-qa
/hj-pr-proposal
E · 開發運維
將使用者自己的 domain、skill 與 tool 內容轉譯為 HJPLUS 台灣建築師知識庫可提交的 PR 草案，涵蓋 fork 檢查、內容對齊、檔案重編、作者確認與提交流程。
HJ PRfork提案草案domain 轉 skill貢獻草案 → skill-authoring-standard
F · 進階開發 / 文件作者（3 個）
/core-reload-dev
F · 進階開發 / 文件作者
opt-in 熱重載開發迭代工作流：不重啟 Revit 即可重建 CoreRuntime → 部署 → 重載 → 驗證，加速 CommandExecutor 類修改的迭代。
熱重載core reloadCoreRuntime不重啟 Revit → core-reload-boundary
/domain-diagram
F · 進階開發 / 文件作者
引導把 domain SOP 流程圖像化：先做流程健檢（迴圈／死路／缺口），再過 scripts/mermaid_from_spec.py 確定性地產出 mermaid 圖並回嵌 domain。
流程圖像化mermaid流程健檢visualize domain → domain-flow-visualization
/dll-to-mcp-tool
F · 進階開發 / 文件作者
把獨立的 Revit IExternalCommand（.cs / DLL，可含 WPF 對話框）封裝為 revit-mcp 工具：產生 C# command handler + dispatcher case + TypeScript 工具定義，建置、雙路徑部署、引導重啟、自動驗證工具上線，最後提交（不 push）。
DLL 封裝封裝成 MCP 工具wrap command as toolIExternalCommand
QUICK TABLE · 速查表

速查：50 Skill 一覽

複製給合作對象 / 列印貼牆。

Forty-two skills arranged as category-coded squares
Skill分類用途主 Domain
/fire-safety-checkA 法規防火時效 / 走廊 / 外牆開口fire-rating / corridor / exterior-wall
/smoke-exhaustA 法規無窗居室 / 排煙有效面積smoke-exhaust-review
/building-complianceA 法規採光比 / 容積率 / 停車daylight / floor-area
/parking-checkA 法規淨空高度 / 數量分類parking-clearance / parking-space-review
/wall-orientation-checkA 法規外牆 Exterior/Interior Sidewall-check
/smoke-detector-checkA 法規偵煙探測器五項規定檢核smoke-detector-check
/curtain-wallB 設計帷幕牆面板配置curtain-wall-pattern
/facade-generationB 設計AI 立面面板生成facade-generation
/element-coloringB 設計依參數值上色element-coloring-workflow
/element-queryB 設計三階段查詢協議element-query-workflow
/auto-dimensionC 文件Ray-Cast / BoundingBox 標註auto-dimension-workflow
/detail-component-syncC 文件AE-numbering 編號同步detail-component-sync
/dependent-view-cropC 文件網格邊界批次裁剪dependent-view-crop-workflow
/sheet-managementC 文件批建圖紙 / 圖號修正 / 視埠sheet-viewport-management
/stair-hidden-lineC 文件剖面樓梯虛線stair-hidden-line-workflow
/wall-section-batchC 文件牆面套管批次平行剖面—
/copy-detail-itemsC 文件批次複製詳圖項目到多視圖—
/dedup-detail-elementsC 文件刪除重複 detail elementdedup-detail-elements-workflow
/text-note-batchC 文件跨視圖批次移動 TextNote—
/align-views-on-sheetsC 文件批次對齊 view 範圍 + viewport 位置—
/batch-apply-view-templateC 文件批次套用 ViewTemplate—
/viewport-arrangementC 文件圖紙視埠排列與對齊—
/scale-drafting-widthC 文件DraftingView 表格寬 / 高縮放—
/floor-plan-from-templateC 文件依範本批次建立樓層平面—
/copy-sheets-cross-projectC 文件跨專案複製含 model views 圖紙—
/excel-to-legendC 文件Excel 表格匯入 Drafting View—
/detect-clashesD 分析MEP × CSA 碰撞mep-csa-clash-detection
/qa-reviewD 分析專案品質檢核qa-checklist
/dwg-beam-importD 分析CAD/DWG 圖層批次建樑dwg-beam-import
/dwg-column-importD 分析CAD/DWG 圖層批次建柱dwg-column-import
/family-inventory-cleanupD 分析族群盤點、purge / merge / renamefamily-inventory-cleanup
/unjoin-geometryD 分析批次解除幾何接合unjoin-geometry-workflow
/batch-room-heightD 分析批次調整房間上限高度room-height-limit
/view-category-visibilityD 分析視圖類別可見性批次控制—
/batch-materialD 分析批次材質修改（複製原材質）—
/partition-takeoffD 分析輕隔間牆數量計算 + CSVrevit-partition-takeoff
/quantity-takeoff-excelD 分析可稽核數量計算 Excelquantity-takeoff-excel
/scaffold-takeoffD 分析室內外施工架數量計算scaffold-takeoff
/tall-partition-indexD 分析高牆（>6m）結構回饋索引圖tall-partition-index-workflow
/threshold-opening-takeoffD 分析房間關聯門窗/門檻統計threshold-opening-takeoff
/room-numberingD 分析房間重新排序 / 自動編號room-numbering-workflow
/ifc-structural-syncD 分析IFC 同步原生梁柱ifc-structural-native-sync
/finish-schedule-governanceD 分析粉刷明細表材料代碼治理finish-schedule-governance
/build-revitE 運維多版本 build(deployment-guide)
/deploy-addonE 運維DLL 部署(deployment-guide)
/claude-md-syncE 運維CLAUDE.md 雙向同步path-maintenance-qa
/hj-pr-proposalE 運維domain/skill 轉譯為 HJ PR 草案skill-authoring-standard
/core-reload-devF 進階opt-in 熱重載開發迭代core-reload-boundary
/domain-diagramF 進階domain SOP 流程圖像化domain-flow-visualization
/dll-to-mcp-toolF 進階把 DLL/.cs 封裝為 MCP 工具—
RATIONALE · 為什麼不每個 Domain 都升級成 Skill

50 Skill vs 72 Domain — 為什麼數量不同？

❌ 反例：把每個 Domain 都升 Skill

40 Skill metadata 全部常駐 → AI context window 被吃掉一大塊 → 真正需要時反而找不到。

且重複邏輯——防火 SOP 同時被消防、走廊、合規三個 Skill 引用，搬到各自 Skill body 內就重複三次。

✓ 本專案做法

Skill = 編排（50 個 metadata 常駐）；Domain = 知識（72 markdown，被引用才載入）。

知識複用，編排薄層。一個防火 SOP 被三個 Skill 共享，原文只有一份。

原則
Skill 加入門檻高：必須有跨多 tool 的編排價值且觸發頻率高到值得常駐 metadata。否則就讓它停在 Domain。
TECHNIQUE
Orchestration vs Knowledge Separation · Metadata Footprint Control · Knowledge Deduplication
CHECKLIST
  • 新 Skill 是否協調 ≥ 2 個 tool？單一 tool 通常不必開 Skill。
  • 觸發關鍵字是否高頻？冷門關鍵字停在 Domain 即可。
  • 是否引用既有 Domain？不寫新知識，寫新編排。