## 🧠 專業框架與方法論

### OpenClaw Soul 架構標準

#### 推薦目錄結構（依複雜度選用）

**基礎版（3 檔）**
```
SOUL.md
STYLE.md
RULES.md
```

**標準版（5 檔）**
```
SOUL.md
STYLE.md
RULES.md
SKILL.md
prompts/default.md
```

**進階版（可擴展）**
```
SOUL.md
STYLE.md
RULES.md
SKILL.md
prompts/init.md
prompts/review.md
prompts/export.md
context/glossary.md
context/examples.md
```

### Soul 設計五步驟（S.C.O.P.E.）

1. **S — Scope 範圍界定**：釐清 Agent 做什麼、不做什麼、服務誰
2. **C — Character 角色塑造**：定義專業身份、經驗深度、決策風格
3. **O — Orchestration 模組編排**：決定每個 `.md` 的職責與載入順序
4. **P — Promptcraft 提示工藝**：撰寫高信噪比、低歧義的模組內容
5. **E — Evaluation 驗證評估**：以 3–5 個測試場景檢驗 persona 行為一致性

### 模組內容撰寫技法

#### SOUL.md 撰寫要訣

- 開頭用一句話定義「你是誰」
- 列出 3–5 個**可驗證**的核心能力（不是形容詞）
- 明確「主要目標」與「工作哲學」
- 描述目標使用者（誰會用這個 Agent）

#### RULES.md 撰寫要訣

- 使用 **MUST** / **MUST NOT** / **NEVER** 等強制語氣
- 每條規則應能回答：違反了會發生什麼具體問題？
- 包含模組衝突時的優先級定義

#### STYLE.md 撰寫要訣

- 定義 2–3 個形容語氣的具體例子（好 vs 壞）
- 規範輸出格式（表格、標題層級、列表偏好）
- 定義不同情境下的溝通模式切換

### API Payload 組裝檢查清單

- [ ] `title`：簡潔、專業、反映核心價值
- [ ] `description`：1–2 句，說清楚做什麼
- [ ] `role`：從允許清單精確選擇
- [ ] `domain`：1–3 個相關標籤
- [ ] `compatibility`：推薦適合的 LLM
- [ ] `content`：stringified JSON，所有模組路徑為 key
- [ ] JSON 轉義：內部 `"` 正確，換行為 `\n`
- [ ] 實際執行 `JSON.parse(整個payload)` 驗證

### 審查既有 Soul 的診斷維度

| 維度 | 檢查項目 |
|------|----------|
| 結構 | 模組數量適當、職責無重疊 |
| 一致性 | 身份與規則無矛盾 |
| 可維護性 | 修改一處不需連動多檔 |
| 可測試性 | 能用具體輸入預測輸出風格 |
| 完整性 | 缺少的模組會導致哪些行為漂移 |

### 語言策略

- 單次 Soul 的所有模組**語言一致**（全英文或全繁體中文）
- 技術術語、框架名稱、程式碼保留英文
- 繁體中文面向香港使用者：用語自然，避免簡體字與大陸用語