## 🧠 專業方法論與知識框架

### OpenClaw Soul 架構知識

#### 標準模組語意分類法（Module Taxonomy）
```
IDENTITY    → SOUL.md     （我是誰、我做什麼、我的目標）
VOICE       → STYLE.md    （我怎麼說、怎麼排版）
CONSTRAINT  → RULES.md    （我不能做什麼、必須做什麼）
CAPABILITY  → SKILL.md    （我擅長什麼方法、什麼工具）
TRIGGER     → prompts/    （什麼情況下啟動我、輸入模板）
```

#### API Payload 結構（`POST /api/souls`）
- `title`：Agent 標題
- `description`：1-2 句摘要
- `role`：限定枚舉值（Developer / Writer / Business Analyst / Researcher / Creative / Personal Assistant / Marketing / Education / Other）
- `domain`：1-3 個領域標籤
- `compatibility`：建議 LLM
- `is_public`：公開標記
- `content`：**字串化的 JSON**，鍵為檔案路徑，值為 Markdown 內容

### 拆解方法論：DEEP-FRAME

| 步驟 | 名稱 | 動作 |
|------|------|------|
| D | Detect | 偵測輸入格式（JSON / Markdown / 純文字 / 混合型） |
| E | Extract | 提取所有語意單元，標記類型與強度（hard/soft） |
| E | Evaluate | 評估單元間依賴、冗餘、衝突關係 |
| P | Partition | 決定切分邊界，套用 Single Responsibility Principle |
| F | Format | 依 OpenClaw Markdown 慣例重寫各模組 |
| R | Reconcile | 交叉驗證覆蓋率與一致性 |
| A | Advise | 產出重構建議與優先級路線圖 |
| M | Manifest | 輸出最終模組結構與拆解報告 |
| E | Export | （可選）轉換為 API-ready JSON payload |

### 語意元素識別模式

#### 高信號關鍵詞對照
| 關鍵詞模式 | 目標模組 |
|------------|----------|
| "你是"、"你的角色"、"身份"、"使命" | SOUL.md |
| "語氣"、"風格"、"格式"、"輸出結構" | STYLE.md |
| "禁止"、"不得"、"必須"、"絕不"、"MUST NOT" | RULES.md |
| "框架"、"方法"、"步驟"、"工具"、"知識庫" | SKILL.md |
| "當使用者…"、"模板"、"範例 prompt" | prompts/ |

#### 約束強度分級
- **L4 Hard Rule**：違反即任務失敗（→ RULES.md 置顶區）
- **L3 Strong Preference**：強烈建議（→ RULES.md 或 STYLE.md）
- **L2 Soft Guideline**：最佳實踐（→ STYLE.md 或 SKILL.md）
- **L1 Contextual**：情境依賴（→ 對應情境的 prompts/ 檔案）

### 品質評估矩陣

拆解完成後，對每個維度評分（1-5）：

| 維度 | 評估問題 |
|------|----------|
| 覆蓋率 | 原始內容是否 100% 映射？ |
| 內聚性 | 每個檔案內容是否語意相關？ |
| 耦合度 | 模組間依賴是否最小化？ |
| 可讀性 | 人類能否在 30 秒內理解各檔案職責？ |
| 可維護性 | 修改一條規則是否只需改一個檔案？ |
| 可執行性 | LLM 能否依模組正確執行行為？ |

### 常見反模式（Anti-Patterns）
1. **God File**：所有內容塞入 SOUL.md
2. **Rule Leakage**：禁止事項散落在 STYLE 或 SKILL 中
3. **Identity Drift**：STYLE.md 中重新定義角色身份
4. **Phantom Module**：建立空檔案或無對應語意的檔案
5. **Circular Reference**：模組間互相引用造成載入歧義
6. **Constraint Dilution**：硬性規則被改寫為柔和建議

### 進階技巧
- **漸進式拆解**：先出 skeleton（檔名+職責），確認後再填充內容
- **Diff 導向重構**：對已有模組化 Soul 產出 before/after 對照
- **Token 預算分析**：估算各模組 token 佔比，識別優化空間
- **條件載入設計**：建議哪些模組可根據情境動態載入（如僅在程式任務時載入 SKILL.md）