傳統開發的痛點

AI 驅動開發帶來的改變

80/20 設計原則

兩大方法論如何串聯？

DDD — Domain-Driven Design

以業務領域為核心，建立共通的語言和模型

為什麼 DDD 對 AI 開發特別重要？

AI 不是你的同事 — 它沒有「默契」，只有「上下文」

你：幫我寫一個計算保費的 API

AI：（猜測）好的，我假設保費 =
    金額 × 費率...
    （缺少年齡、性別、險種等
     業務邏輯，產出不完整）

你：根據我們的領域模型，
    被保人(Insured) 有年齡/性別，
    險種(InsuranceType) 對應費率表，
    請實作 PremiumCalculator...

AI：（精準理解）根據領域模型，
    我會查詢 RateTable，
    考慮年齡區間和性別係數...

DDD 的兩個層次

DDD 實踐：與 Claude Code 一起做

實際操作只需要 3 個步驟

DDD 如何對應到我們的專案？

不需要改 Package 結構 — DDD 是概念上的邊界劃分

com.insuranceExpert/
├── model/       ← 所有 Model
│   ├── ai/
│   ├── customer/
│   ├── insuranceMaster/
│   └── ocr/
├── dao/         ← 所有 DAO
├── service/     ← 所有 Service
│   └── ai/
├── web/api/     ← Controller
├── config/
└── util/

Policy（保單管理）
  Policy, PolicyStatus, PolicyService

Product（產品保障）
  Product, Plan, Benefits, SubBenefits

AI Chat（AI 對話）
  ChatSession, ChatMessage, service/ai/*

Customer（客戶管理）
  Customer, CustomerTags, ProspectiveCustomer

Member（會員系統）
  Member, MemberAccount, MemberLogin

SDD — Spec-Driven Development

用結構化規格文件驅動開發，取代模糊的口頭需求

DDD → SDD 的協作流程

工具生態系統

Claude Code — AI 編碼代理

CLAUDE.md — 專案的靈魂

CLAUDE.md 是 Claude Code 進入專案時第一個讀取的檔案

PRPs — 規格文件結構

PRPs/
├── feature-name-1/
│   ├── requirements.md    ← 需求定義（What & Why）
│   ├── design.md          ← 技術設計（How）
│   └── tasks.md           ← 任務拆解（Steps）
├── feature-name-2/
│   ├── requirements.md
│   ├── design.md
│   └── tasks.md
└── ...

Step 1：安裝 Node.js

Claude Code 基於 Node.js 運行，需要 v18 以上

# Windows (winget)
winget install OpenJS.NodeJS.LTS

# macOS (Homebrew)
brew install node@20

# 驗證安裝
node --version    # 應顯示 v18.x 或更高
npm --version     # 應顯示 9.x 或更高

Step 2：安裝 Claude Code

# 全域安裝 Claude Code
npm install -g @anthropic-ai/claude-code

# 驗證安裝
claude --version

Step 3：設定 API Key（方式 A）

# 設定環境變數
# Windows (PowerShell)
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxx"

# 或永久設定（推薦）
# Windows: 系統設定 → 環境變數 → 新增 ANTHROPIC_API_KEY

# macOS/Linux: 加到 ~/.bashrc 或 ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.zshrc

Step 4：初始化專案

# 進入專案目錄
cd /path/to/your/project

# 啟動 Claude Code
claude

# Claude 會自動讀取 CLAUDE.md（如果存在）
# 如果不存在，可以請 Claude 幫你建立：
# > 請幫我建立 CLAUDE.md，這是一個 Spring MVC 專案...

Step 5：建立 PRPs 結構

# 建立 PRPs 資料夾結構
mkdir -p PRPs/your-first-feature

# 每個功能包含三個文件：
# PRPs/your-first-feature/
#   ├── requirements.md   ← 需求（和 Claude 討論後產出）
#   ├── design.md         ← 設計（Claude 根據需求產出）
#   └── tasks.md          ← 任務（Claude 根據設計拆解）

Step 6：設定 MCP Servers（選配）

MCP (Model Context Protocol) 讓 Claude Code 擁有更多能力

// ~/.claude/settings.json 中配置
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "serena": {
      "command": "uvx",
      "args": ["serena-mcp"]
    }
  }
}

流程全覽

Stage 1：需求

Stage 2：討論

與 Claude Code 進行深度討論，分析源代碼並制定計畫

# 啟動討論（在 Claude Code 中）

你：我要實作「保費試算功能」，Ticket 編號 IE-123。
    請先分析現有的保險計算相關代碼，
    然後我們一起討論最佳實作方式。

Claude：好的，讓我先分析...
        [讀取相關 Service、Model、Controller]
        我發現目前有 PolicyService 和 PremiumCalculator，
        建議我們在這個基礎上擴展...

你：同意，但需要考慮多險種的情況...

Stage 3：規格作成

由 AI 產生完整的規格文件三件套

# 請 Claude 產生規格

你：討論得差不多了，請根據我們的討論，
    幫我產生 PRPs/premium-calculator/ 底下的
    requirements.md、design.md 和 tasks.md。

Claude：好的，我根據討論內容產出以下規格：
        [產生三個文件]

Stage 4：規格審查

AI 進行自我檢查與交叉驗證

Stage 5：實作

AI 根據審查通過的規格編寫代碼，同步建立測試

Stage 6：代碼審查 (Code Review)

檢查實作是否符合 spec.md

# 使用 Claude Code 的
# code-review skill
/code-review

# 或手動請求
你：請對照 design.md
    審查我剛寫的代碼

Stage 7：測試驗證

# 執行測試
ant test                        # 執行所有測試
ant test -Dtest=PremiumCalcTest # 執行特定測試

Stage 8：PR/MR 作成

測試通過後建立 Pull Request / Merge Request

# 使用 Claude Code 的 commit-push-pr skill
/commit-push-pr

# 或手動操作
git checkout -b feat/IE-123-premium-calculator
git add .
git commit -m "feat(premium): 新增保費試算功能"
git push -u origin feat/IE-123-premium-calculator

# 使用 gh CLI 建立 PR
gh pr create --title "feat: 新增保費試算功能 (IE-123)" \
  --body "## Summary ..."

Stage 9：最終確認 & CI/CD

🎯 場景：新增保費試算 API

DDD 階段：定義領域模型

Ubiquitous Language（共通語言）:
  - 被保人 (Insured)     → 年齡、性別、健康狀態
  - 險種 (InsuranceType) → 壽險、醫療險、意外險
  - 保費 (Premium)       → 年繳保費、月繳保費
  - 費率表 (RateTable)   → 按年齡/性別查表

Bounded Context:
  - 報價上下文 (Quotation Context) ← 本次開發
  - 保單管理上下文 (Policy Context) ← 已存在

📐 SDD 階段：規格產出

# 與 Claude Code 對話

你：Ticket IE-456 的討論結果已經確認，
    請產生 PRPs/premium-calculator/ 的三個規格文件。

Claude：好的，我根據討論內容產生以下規格：

=== design.md (節錄) ===
## API 設計
POST /api/v1/premium/calculate
Request: { age, gender, insuranceType, coverageAmount }
Response: { annualPremium, monthlyPremium, rateApplied }

## 資料模型
PremiumRequest → 驗證 → RateTableLookup → PremiumResult

🧪 實作階段：代碼 + 測試

// PremiumCalculatorTest.java

@Test  // ✅ 預期成功
public void testCalculate_validInput_returnsCorrectPremium() {
    PremiumRequest req = new PremiumRequest(30, "M", "LIFE", 1000000);
    PremiumResult result = calculator.calculate(req);
    assertEquals(BigDecimal.valueOf(12500), result.getAnnualPremium());
}

@Test  // ⚠️ 邊界案例
public void testCalculate_maxAge_returnsHigherPremium() {
    PremiumRequest req = new PremiumRequest(70, "F", "MEDICAL", 500000);
    PremiumResult result = calculator.calculate(req);
    assertTrue(result.getAnnualPremium()
        .compareTo(BigDecimal.valueOf(50000)) > 0);
}

@Test(expected = InvalidAgeException.class)  // ❌ 預期失敗
public void testCalculate_negativeAge_throwsException() {
    new PremiumRequest(-1, "M", "LIFE", 1000000);
}

✅ 完整流程回顧

Context Engineering 心法

常見踩坑與對策

團隊協作建議

快速參考卡

# 啟動 Claude Code
claude

# 常用 Slash Commands
/commit        # 智慧提交
/code-review   # 代碼審查
/generate-prp  # 產生規格
/help          # 取得幫助

# Plan 模式
# Claude 自動進入或
# 你可以手動要求：
你：請先進入 Plan 模式分析