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