# 架構挑戰 (Challenge Architecture) 技能指南 ## 概述 `challenge-architecture` 是 Architect Pipeline 的第三個步驟,用來對架構決策做高強度審查、驗證 PRD 可追溯性、偵測過度設計與不足設計。此技能以安靜的批次審計模式運作,不會互動式提問。 ## 輸入與輸出 ### 輸入 - `docs/architecture/{feature}.md` - `docs/prd/{feature}.md` ### 輸出 - 更新後的 `docs/architecture/{feature}.md` ## 審計模式 此技能以**安靜審計 / 批次審查**模式運作: - 完整閱讀 PRD 與架構文件 - 安靜執行所有驗證階段 - 產出單一結構化審查報告 - 直接將所有修補套用到架構文件 - 不會一次問一個問題或互動式提示 ## 審計階段 1. **可追溯性**:每個架構元素是否回溯到 PRD 需求 2. **覆蓋度**:每個 PRD 需求是否有架構對應 3. **擴展性**:服務是否能獨立擴展、是否有單點失敗 4. **一致性**:一致性模型是否明確、Race condition 是否識別 5. **安全性**:認證/授權邊界是否定義 6. **整合**:外部系統整合是否識別、失敗模式是否定義 7. **可觀測性**:Logs、Metrics、Traces 是否完整 8. **資料完整性**:資料是否可能遺失、交易邊界是否合適 9. **過度設計偵測**:過於複雜的架構決策 10. **不足設計偵測**:遺漏的需求對應 ## 審查輸出格式 - Traceability Gaps - Missing Decisions - Over-Engineering - Under-Engineering - Risks - Required Revisions ## 閘道決策 - **PASS**:所有修補已套用,無剩餘阻擋 - **CONDITIONAL PASS**:存在不阻擋 Planner 交接的小缺口 - **FAIL**:需要重大修訂,需回到 `design-architecture` ## 不應做的事 - 不以互動方式提問 - 不改變 PRD 範圍 - 不從頭設計架構 - 不做實作層級決策 - 不拆分任務