DDD 架構輔助技能

觸發條件

可用工具

此技能使用標準檔案操作：

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"
)

# 如果有結果 → 違規！

違規類型與修復

輸出範例

🏗️ DDD 架構檢查

✅ 依賴方向正確
✅ DAL 正確分離
⚠️ 警告：
  - src/domain/services/user_service.py:15
    導入了 infrastructure 模組

建議：
  將資料庫操作移至 Repository

相關技能

• code-refactor – 重構違規程式碼
• code-reviewer – 審查程式碼品質