# QA Review

> 專案品質檢核：圖紙編號一致性、詳圖元件完整性、視圖組織、參數正確性、MCP 系統健康度。觸發條件：使用者提到 QA、品質檢查、驗證、一致性、專案檢核、系統健康、quality check、review。工具：get_all_sheets、get_detail_components、get_all_views、query_elements_with_filter。

- Skill: `shuotao/qa-review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add shuotao/qa-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shuotao/qa-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: shuotao (https://skillmd.com/u/shuotao)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/shuotao/qa-review

---


# 專案品質檢核

## Checklist

### 1. 圖紙與編號一致性
- [ ] 所有圖紙使用正確的編號格式（`[專業碼]-[類型][流水號]`）
- [ ] 沒有 `-1` 後綴的重複號碼
- [ ] 圖紙名稱與內容一致
- [ ] 所有視圖已放置到對應圖紙

### 2. 詳圖元件完整性
- [ ] 所有詳圖圖頭參數已匹配
- [ ] 沒有孤兒類型（零實例的類型）
- [ ] 類型命名遵循 `{圖紙號碼}-{圖紙名稱}-{詳圖名稱}` 規則

### 3. 視圖組織
- [ ] 所有視圖已分配到圖紙或標記為工作視圖
- [ ] 視圖樣版一致性套用
- [ ] 沒有重複的視圖名稱

### 4. 參數正確性
- [ ] 防火時效參數已填入所有相關牆體
- [ ] 房間名稱與編號完整
- [ ] 樓層指定正確

### 5. MCP 系統健康度
- [ ] WebSocket 連線（port 8964）回應正常
- [ ] 所有已註冊的工具能正確回傳結果
- [ ] Build 產物與原始碼版本一致

### 6. 跨文件數字一致性（Phase 7）
- [ ] CLAUDE.md / `docs/BIM_MCP/**/*.html` / `_shared.js` 內的 Skill / Domain / Tool 數量與 source 真值對齊
- [ ] `domain/*.md` 每個非 meta 檔都在 CLAUDE.md「Domain Knowledge & Workflow Files」表格中出現一次（雙向）
- [ ] BIM_MCP 網頁 `href="../../domain/*.md"`、`href="../../.claude/skills/*"` 連結目標真實存在

→ 由 `scripts/verify-qaqc.ps1` 的 Phase 7 自動執行；白名單：archive、log、明示 snapshot 的歷史 HTML。

## Execution

依序執行檢查：
1. `get_all_sheets` → 驗證編號
2. `get_detail_components` → 驗證圖頭完整性
3. `get_all_views` → 驗證視圖組織
4. `query_elements_with_filter` → 抽查參數
5. 產出合格/不合格摘要報告

## Path Maintenance

修改檔案路徑或參照時：
- 確認所有 domain 文件的交叉參照仍然有效
- 確認 CLAUDE.md 的觸發關鍵字表是否需要更新
- 確認 Skill 描述與目前可用工具一致

## Reference

詳見 `domain/qa-checklist.md`、`domain/path-maintenance-qa.md`。