opencode-workflow/skills/system-decomposition

系統分解 (System Decomposition) 知識合約指南

概述

system-decomposition 是知識合約，用來提供將系統拆分為服務或模組的原則。包含邊界定義、資料所有權與依賴方向。供 design-architecture 在設計 Service Boundaries 時參考。

核心原則

• 每個服務或模組必須有單一、明確的職責
• 資料所有權必須明確：每筆資料只屬於一個服務
• 依賴必須單向流動；嚴禁循環依賴
• 邊界必須環繞領域職責繪製，而非技術分層

設計重點

Modular Monolith vs Microservices

• 選擇 Modular Monolith：團隊小、邊界仍在演化、部署簡單優先
• 選擇 Microservices：個別服務有不同擴展需求、團隊擁有對齊、獨立部署是需求

領域邊界

• 一起變化的實體
• 內聚的業務規則
• 一起存取的資料
• 橫跨一致上下文的使用者工作流

好的邊界：高內聚、低外部耦合、可獨立理解、可獨立部署。

耦合 vs 內聚

• 偏好邊界內高內聚
• 最小化邊界間耦合
• 透過明確合約（API、事件）溝通
• 避免共享資料庫表

狀態所有權

• 每筆狀態只有一個擁有者
• 其他服務透過擁有者的 API 或事件存取
• 嚴禁服務直接讀取另一服務的資料庫

知識合約職責

• 提供系統分解的理論指引
• 不替 PRD 做最終邊界決策

不應做的事

• 不替系統定義特定服務邊界
• 不假設 Microservices 適合所有場景
• 不忽略領域邊界而以技術分層