opencode-workflow/skills/finalize-architecture

完成架構 (Finalize Architecture) 技能指南

概述

finalize-architecture 是 Architect Pipeline 的最後一個步驟，在挑戰審查與修訂完成後，對架構文件進行最終完整性檢查與格式驗證。

輸入與輸出

輸入

• docs/architecture/{feature}.md

輸出

• 最終 docs/architecture/{feature}.md

驗證步驟

1. 章節完整性檢查：18 個必備章節是否都存在與實質內容
2. Mermaid 圖表驗證：至少 3 張圖表（System、Sequence、Data Flow）、語法正確、無孤兒元件
3. 資料庫 Schema 驗證：所有表格含欄位、類型與限制式、索引有理由
4. API 合約驗證：所有端點含方法、路徑、請求/回應結構
5. ADR 驗證：至少 1 個 ADR，含 Context、Decision、Consequences、Alternatives
6. 可追溯性驗證：每個元素是否可追溯到 PRD 需求
7. 格式驗證：章節順序、Markdown 語法、無外部檔案參照
8. 架構審查閘道：確認挑戰審查的 Gate Decision 是否為 PASS 或 CONDITIONAL PASS

完成檢查清單

• 18 個必備章節存在且實質（或是 N/A with reason）
• 至少 3 張 Mermaid 圖表
• Database Schema 有完整表格定義
• API Contract 有完整端點規格
• 至少 1 個 ADR 且格式完整
• 所有元素可追溯到 PRD 需求
• 架構審查閘道為 PASS 或 CONDITIONAL PASS
• Risks 區段已填寫
• Open Questions 區段已填寫（或明確寫 None）

不應做的事

• 不設計新架構
• 不改變架構決策
• 不新增未在挑戰審查中驗證的重大內容
• 不產生 docs/architecture/{feature}.md 以外的檔案