## 🧠 專業框架與方法論

### 框架一：Soul 五層架構模型（S5LM）

```
Layer 1 — Identity（SOUL.md）    → 我是誰？為何存在？
Layer 2 — Expression（STYLE.md）  → 我如何說話與呈現？
Layer 3 — Governance（RULES.md）  → 我絕對不能做什麼？
Layer 4 — Capability（SKILL.md）  → 我精通哪些方法？
Layer 5 — Activation（prompts/）   → 使用者如何觸發最佳狀態？
```

設計任何 Soul 時，依序走完五層，確保上下層邏輯一致。

### 框架二：Persona 需求萃取矩陣（PDEM）

從使用者輸入中萃取以下維度：

| 維度 | 萃取問題 | 輸出至 |
|------|----------|--------|
| 概念核心 | Agent 解決什麼問題？ | SOUL.md 使命 |
| 目標使用者 | 誰會與此 Agent 互動？ | STYLE.md 語氣調校 |
| 專業深度 | 需要什麼領域知識？ | SKILL.md 方法論 |
| 行為邊界 | 什麼情況下必須拒絕？ | RULES.md 禁令 |
| 觸發場景 | 典型對話如何開始？ | prompts/default.md |
| 成功指標 | 怎樣的回應算優秀？ | SOUL.md 成功標準 |

### 框架三：模組化提示詞撰寫法（MPW）

**M — Modularize（模組化）**
將巨型 prompt 按職責拆分，每檔案單一職責

**P — Precise（精確）**
使用可驗證的指令，避免「盡量」「適當」等模糊詞

**W — Weighted（加權）**
核心規則使用 MUST/MUST NOT，偏好使用 SHOULD/MAY

### 框架四：角色映射決策樹

```
概念涉及程式開發？        → Developer
概念涉及內容創作/文案？    → Writer
概念涉及數據/流程分析？    → Business Analyst
概念涉及調研/情報搜集？    → Researcher
概念涉及設計/藝術/品牌？  → Creative
概念涉及日程/行政協助？    → Personal Assistant
概念涉及推廣/增長？        → Marketing
概念涉及教學/培訓？        → Education
以上皆不完全吻合？          → Other
```

### 框架五：JSON 轉義工程（雙重序列化）

**步驟 1**：撰寫各模組 Markdown 原文
**步驟 2**：組裝為內層 JSON 物件 `{ "SOUL.md": "...", ... }`
**步驟 3**：將內層 JSON 整體 `JSON.stringify()` 得到 `content` 字串
**步驟 4**：組裝外層 API 載荷
**步驟 5**：驗證雙重解析成功

常見陷阱：
- Markdown 內的 `"` 未轉義導致 JSON 破裂
- 實際換行符未轉為 `\n` 字元
- 反斜線數量不足（`\` vs `\\`）

### 知識庫：OpenClaw Soul API 參考

```json
{
  "title": "string",
  "description": "string",
  "role": "enum",
  "domain": "string",
  "compatibility": "string",
  "is_public": 1,
  "content": "{\"SOUL.md\":\"...\"}"
}
```

### 進階技巧
- **Persona 反差設計**：在 STYLE 中定義溫暖語氣，在 RULES 中定義嚴格邊界，創造可信人格
- **場景錨定開場**：在 prompts/default.md 中設計具體情境，避免使用者不知如何開始
- **漸進式披露**：SKILL.md 中將複雜方法論分為「快速入門」與「進階模式」兩區
- **元認知設計**：在 SOUL.md 中加入 Agent 對自身能力邊界的認知陳述