## 🧰 專業框架與方法論

### OpenClaw Soul 模組標準結構

```
soul-root/
├── SOUL.md          # 身份、使命、成功標準
├── STYLE.md         # 語氣、格式、術語
├── RULES.md         # 硬性邊界、禁止事項
├── SKILL.md         # 方法論、檢查清單（可選）
└── prompts/
    ├── default.md   # 預設觸發模板
    ├── init.md      # 冷啟動／新專案
    └── review.md    # 演進審查專用
```

### Soul 成熟度模型（SMM）

| 等級 | 特徵 | 演進建議 |
|------|------|----------|
| L0 草稿 | 單檔提示、無版本 | 拆分 SOUL/RULES，建立 v0.1.0 |
| L1 模組化 | 3+ 檔案、手動部署 | 加入 changelog、compat 標註 |
| L2 可治理 | semver + review 流程 | 建立 eval 基線、canary |
| L3 可觀測 | 指標、drift 告警 | 自動化 regression suite |
| L4 產品化 | 多 Soul 族譜、模板庫 | 抽取共用 core，差異化 overlay |

### 版本策略決策樹

```
變更類型？
├─ 僅 STYLE 措辭、排版 → PATCH (x.x.+1)
├─ 新增 SKILL／prompt 模板、擴充能力 → MINOR (x.+1.0)
├─ 改寫身份、放寬/收緊 RULES、改 role → MAJOR (+1.0.0)
└─ 模組路徑重構（檔名/目錄）→ MINOR 或 MAJOR（視是否破壞載入器）
```

### Soul 健康度稽核（SHA）

每次演進諮詢可執行八項快篩：

1. **模組內聚**：每檔是否單一職責
2. **重複率**：跨檔重複段落 < 5%
3. **衝突掃描**：RULES 與 STYLE/SKILL 是否矛盾
4. **長度預算**：總 token 與各檔占比是否合理
5. **API 合規**：stringified JSON 可解析性
6. **語言一致**：模組間主語言統一
7. **可測性**：是否有明確成功標準可供 eval
8. **可回滾性**：上一版 artifact 是否可追溯

評分：每項 0–2 分，總分 16；< 10 建議暫緩 major release。

### 漸進演進模式

**Strangler Prompt Pattern**
1. 識別高 churn 模組（常改 STYLE、prompts）
2. 凍結低 churn 核心（SOUL 使命、核心 RULES）
3. 新行為先寫入 `prompts/experimental.md` 或 canary Soul
4. eval 通過後合併至 Stable

**Soul Fork & Merge**
- 實驗分支：`soul-brand-a-canary`
- 穩定主線：`soul-brand-a-stable`
- 定期將通過審查的 diff cherry-pick 回主線

### Eval 與 Drift 偵測

建議最小 eval 集：
- **身份一致性**：10 題「你是誰／你做什麼」
- **邊界遵守**：10 題越權、敏感場景
- **風格穩定**：5 題格式與語氣
- **任務能力**：5 題核心 SKILL 場景

Drift 信號：
- 身份回答偏離 SOUL.md 關鍵詞 > 20%
- RULES 違規率上升
- 使用者「不像之前」回饋激增

### Migration 檢查清單

從舊 Soul 遷移時：
- [ ] 盤點舊提示所有段落並映射至模組
- [ ] 刪除失效或重複指令
- [ ] 建立 `MIGRATION.md` 或 changelog 條目
- [ ] 驗證 `POST /api/souls` payload
- [ ] 並行運行舊版 7 天（若可行）
- [ ] 確認 `compatibility` 與目標模型
- [ ] 更新 `prompts/default.md` 觸發語

### 長期 Roadmap 模板

| 時間 | 目標 | 產出 | 風險 |
|------|------|------|------|
| 30 天 | L0→L1 模組化 | 拆分檔案 + v1.0.0 | 行為微變 |
| 90 天 | L1→L2 治理 | review 流程 + eval 基線 | 團隊共識 |
| 180 天 | L2→L3 觀測 | drift 指標 + canary 管線 | 維護成本 |

### 常用產出物

- Soul Diff Summary（表格：檔案、變更類型、版本影響）
- API Payload 草案（含 escape 注意事項）
- Module Ownership Matrix（誰維護哪個 md）
- Deprecation Notice 範本