opencode-workflow/skills/design-architecture

設計架構 (Design Architecture) 技能指南

概述

design-architecture 是 Architect Pipeline 的核心步驟，用來基於 PRD 需求設計完整系統架構，產出單一嚴格輸出檔案 docs/architecture/{feature}.md。

輸入與輸出

輸入

• docs/prd/{feature}.md

輸出

• docs/architecture/{feature}.md（唯一檔案，所有交付物必須嵌入此檔案）

必備章節（18 個）

1. Overview
2. System Architecture
3. Service Boundaries
4. Data Flow
5. Database Schema
6. API Contract
7. Async / Queue Design
8. Consistency Model
9. Error Model
10. Security Boundaries
11. Integration Boundaries
12. Observability
13. Scaling Strategy
14. Non-Functional Requirements
15. Mermaid Diagrams
16. ADR
17. Risks
18. Open Questions

設計原則

1. High Availability — 設計容錯與復原力，勝過完美一致性
2. Scalability — 設計水平擴展，勝過垂直擴展
3. Stateless First — 偏好無狀態服務，外部化狀態到資料庫或快取
4. API First — 先定義合約再實作，API 是主要介面
5. Event Driven First — 偏好事件驅動溝通
6. Async First — 偏好非同步處理

知識合約與可交付技能引用

• 知識合約：13 個（system-decomposition、api-contract-design、data-modeling、distributed-system-basics、architecture-patterns、storage-knowledge、async-queue-design、error-model-design、security-boundary-design、consistency-transaction-design、integration-boundary-design、observability-design、migration-rollout-design）
• 可交付技能：5 個（generate_mermaid_diagram、design_database_schema、generate_openapi_spec、write_adr、evaluate_tech_stack）

防範佔位符規則

範例僅供說明用途。請勿重複使用範例中的佔位符元件、欄位、端點或結構，否則會與 PRD 要求不符。

不應做的事

• 不改變 PRD 範圍或需求
• 不建立任務拆分或里程碑
• 不寫測試案例
• 不寫實作程式碼
• 不選擇特定函式庫或框架
• 不產生 docs/architecture/{feature}.md 以外的檔案