opencode-workflow/skills/challenge-architecture

架構挑戰 (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 範圍
• 不從頭設計架構
• 不做實作層級決策
• 不拆分任務