先寫知識，
再寫編排，最後才新增工具

三選一：先判斷你要貢獻哪一層

大多數新需求其實是「知識補完」不是「工具擴充」。先判斷對，省下重造輪子的時間。

Domain 撰寫骨架

所有 domain/*.md 都遵守這個結構。frontmatter 由 /qaqc Phase 6 lint 檢核。詳見 frontmatter-standard.md。

---
title: parking-clearance-check
description: 停車位淨高與車道寬度檢核 SOP（建技 §60）
type: compliance
triggers:
  - parking
  - clearance
  - 停車淨高
  - >210cm
inputs:
  - element ids from get_field_values
  - room types from get_rooms_by_level
references:
  - building-code-tw.md#article-60
---

# Goal
明確定義本 SOP 的範圍與目的。

# Method
1. 列出需要的 tool fields（不要假設）
2. 寫公式與閾值
3. 列出例外（哪些情境不檢、哪些要替代條件）
4. 多重條件時用決策樹清楚畫出來

# Output
回傳 PASS / FAIL / NEEDS_REVIEW 三態（不是只 PASS/FAIL）。
含 evidence（用了哪些 element id、哪個欄位、套了哪個公式）。

# Edge cases
- 機車位的 clearance 規則不同
- 無障礙車位有更高要求
- 雙層機械停車位特殊計算

Skill 只負責 orchestration

Skill body 大多 ≤ 50 行。長 Skill 通常 = 把 SOP 重複寫進去 = 違反知識複用原則。

---
name: parking-check
description: 停車淨高與車位數量檢核。觸發於關鍵字「停車」「車位淨高」「parking」「clearance」「機車位」「無障礙車位」。
trigger-keywords:
  - 停車
  - parking
  - clearance
---

# Workflow

1. 讀對應 Domain SOP（一定要讀，不要憑記憶套）
   - 淨高檢查 → domain/parking-clearance-check.md
   - 數量檢核 → domain/parking-space-review.md

2. 查實際模型資料（用 tool 取，不要編造）
   - get_rooms_by_level(level=X) 取停車空間
   - query_elements_with_filter(category="Parking") 取車位

3. 套 SOP 方法（domain 怎麼寫就怎麼算）
   - 不要簡化、不要憑直覺、不要跳步驟

4. 回報結果
   - PASS / FAIL / NEEDS_REVIEW + 證據
   - 若 FAIL → 建議套 A/B/C/D 框架（指向 spectrum-decision）

6 步驟範例：新增「停車淨高檢核」

從零開始建一個新 compliance SOP。用真實案例（這是 2025-Q4 實際做過的，現已上線）。

1. 建立 domain/parking-clearance-check.md

   依 Section 02 骨架填入。完整公式：淨高 ≥ 2100mm；機車位 ≥ 1800mm；無障礙 ≥ 2400mm。

   # Method
   1. Get all rooms with type ∈ {駐車場, parking, 停車空間}
   2. For each room: measure ceiling height at room center
   3. Classify: regular / 機車 / 無障礙
   4. Apply threshold per class
   5. Output FAIL list with evidence

2. 更新 .claude/skills/parking-check/SKILL.md

   把 workflow 加上「淨高檢查」分支。若該 Skill 還不存在則新建。

3. 寫最小測試 / smoke script

   避免工具 schema 漂移。建一個 tests/parking-clearance.smoke.ts，跑一遍確認 round-trip 通過。

4. 更新 CLAUDE.md 觸發表

   加入這行到 Domain 表：

   | 停車, 車位淨高, clearance, >210cm | `domain/parking-clearance-check.md` |

5. 更新本 reference 索引

   在 domain-index Section 02 Compliance 加入新 card，含 trigger tags 與反查 Skill。在 skills-index 對應 Skill 加上 domain-link。

6. PR Review · 跑 /claude-md-sync 與 /qaqc

   同步驗證 CLAUDE.md 與作業檔雙向一致。qaqc Phase 6 會檢核 frontmatter 完整性。

PR Review Checklist

CODEOWNERS 收到 PR 後對照這份檢核。沒過不 merge。