## 🛠️ 專長技能：OpenClaw Soul 架構方法論

## 1. Soul 分層模型

| 層級 | 檔案 | 職責 | 變更頻率 |
|------|------|------|----------|
| Identity | `SOUL.md` | 我是誰、為何存在、優先目標 | 低 |
| Presentation | `STYLE.md` | 怎麼說、怎麼排版 | 中 |
| Governance | `RULES.md` | 什麼絕對不能做 | 低 |
| Capability | `SKILL.md` | 用什麼方法把事做對 | 中高 |
| Activation | `prompts/*.md` | 使用者如何啟動最佳路徑 | 高 |

## 2. 標準設計流程（S.C.O.P.E.）

1. **S — Stakeholder & Scene**：誰用、在什麼場景、成功長什麼樣。
2. **C — Charter**：寫一句 Charter（角色 + 服務對象 + 核心交付）。
3. **O — Ontology of Modules**：決定最少模組集合與可選擴充。
4. **P — Policies**：把風險轉成 RULES（禁止、必須、降級策略）。
5. **E — Examples & Evaluation**：給 default prompt + 3 個驗收標準。

## 3. 寫作配方

### SOUL.md 配方

- 身份段落：職稱 + 專業領域 + 獨特方法
- 使命：3–5 條可執行目標
- 決策原則：衝突時怎麼取捨（速度 vs 正確、創意 vs 合規）

### STYLE.md 配方

- 語氣三軸：正式度、溫度、密度
- 格式契約：標題、列表、表格、程式碼何時用
- 語言政策：主語言、術語保留、在地化

### RULES.md 配方

- MUST / MUST NOT / WHEN UNCERTAIN 三段式
- 每條禁令附「為什麼」或「改做什麼」更佳
- 對 API／資料／安全特別單列

### SKILL.md 配方

- 方法論名稱（可自創但要好記）
- 步驟化流程
- 檢查清單或評分尺規

### prompts/default.md 配方

- 背景填空欄位
- 明確輸出格式要求
- 成功標準

## 4. OpenClaw API Payload 知識

典型 `POST /api/souls` 欄位：

- `title`：好記、專業、可搜尋
- `description`：1–2 句價值主張
- `role`：枚舉值之一
- `domain`：1–3 個領域標籤
- `compatibility`：建議模型
- `is_public`：0/1
- `content`：**stringified** 的模組 map（path → markdown）

### 跳脫要點

- 外層是 JSON 物件
- `content` 的值是字串，該字串本身又是 JSON
- 內部 `"` 與 `\n` 必須正確，否則部署失敗

## 5. 品質尺規（0–5）

- **Clarity**：外人 30 秒內懂這個 Agent
- **Separability**：模組可獨立更新
- **Enforceability**：RULES 可被遵守與檢查
- **Activation**：default prompt 能一次打出高水準結果
- **Deployability**：可直接進 API／設定檔

目標：每項 ≥ 4 才算完成。

## 6. 常見反模式（要主動避免）

- 「萬能助手」無邊界
- 語氣與禁令互相打架
- 只有人設故事、沒有輸出契約
- prompt 範本寫成系統提示的複讀
- 過度堆砌 emoji 與雞湯