DDD 架構輔助技能
觸發條件
| 用戶說法 |
觸發 |
| 新增功能、新模組 |
✅ |
| 架構檢查、設計 |
✅ |
| 建立新檔案時 |
✅ 自動檢查 |
可用工具
此技能使用標準檔案操作：
| 操作 |
工具 |
| 搜尋 import |
grep_search(query="from.*import", isRegexp=True) |
| 檢查目錄 |
list_dir() |
| 讀取檔案 |
read_file() |
| 建立檔案 |
create_file() |
DDD 層級結構
src/
├── domain/ # 領域層（核心業務邏輯）
│ ├── entities/ # 實體
│ ├── value_objects/# 值物件
│ ├── aggregates/ # 聚合根
│ ├── repositories/ # Repository 介面（抽象）
│ └── services/ # 領域服務
├── application/ # 應用層
│ ├── use_cases/ # 用例
│ └── dtos/ # 資料傳輸物件
├── infrastructure/ # 基礎設施層
│ ├── persistence/ # 資料庫實作
│ └── services/ # 外部服務實作
└── interfaces/ # 介面層
├── api/ # REST API
└── mcp/ # MCP Server
依賴規則
✅ 允許的依賴方向：
Presentation → Application → Domain
Infrastructure → Domain (實作介面)
❌ 禁止的依賴：
Domain → Infrastructure
Domain → Application
Application → Presentation
標準工作流程
流程 A：建立新功能腳手架
# 「新增 Order 領域」
# 1. 建立 Domain 層
create_file("src/domain/entities/order.py", "class Order: ...")
create_file("src/domain/repositories/order_repository.py", "class IOrderRepository(ABC): ...")
# 2. 建立 Application 層
create_file("src/application/use_cases/create_order.py", "class CreateOrder: ...")
create_file("src/application/dtos/order_dto.py", "@dataclass class OrderDTO: ...")
# 3. 建立 Infrastructure 層
create_file("src/infrastructure/persistence/order_repository.py", "class OrderRepository(IOrderRepository): ...")
流程 B：架構違規檢查
# 檢查 Domain 層是否導入 Infrastructure
grep_search(
query="from.*infrastructure.*import",
isRegexp=True,
includePattern="**/domain/**/*.py"
)
# 如果有結果 → 違規！
違規類型與修復
| 違規 |
問題 |
修復 |
| Domain → Infrastructure |
領域層不應依賴基礎設施 |
使用 Repository 介面 |
| 直接 SQL 在 Domain |
資料存取應在 Infrastructure |
抽出到 Repository |
| Application → DB |
應用層不應直接操作資料庫 |
透過 Repository |
輸出範例
🏗️ DDD 架構檢查
✅ 依賴方向正確
✅ DAL 正確分離
⚠️ 警告：
- src/domain/services/user_service.py:15
導入了 infrastructure 模組
建議：
將資料庫操作移至 Repository
相關技能
code-refactor - 重構違規程式碼code-reviewer - 審查程式碼品質
majiayu000