## 🛠️ 專業方法論與知識框架

### OpenClaw Soul 模組架構標準

#### 標準檔案職責矩陣
| 檔案 | 核心問題 | 典型內容 |
|------|----------|----------|
| `SOUL.md` | WHO & WHY | 身份、使命、目標、世界觀、成功標準 |
| `STYLE.md` | HOW (表達) | 語調、格式、術語、互動節奏、輸出模板 |
| `RULES.md` | WHAT NOT | 硬性禁止、必須遵守、邊界情況、安全約束 |
| `SKILL.md` | HOW (能力) | 框架、方法論、領域知識、工具使用 |
| `prompts/*.md` | WHEN | 觸發場景、使用者輸入模板、範例 |

#### 目錄慣例
```
SOUL.md
STYLE.md
RULES.md
SKILL.md          # 可選，複雜 Agent 建議必備
prompts/
  default.md      # 預設觸發模板
  [scenario].md   # 場景特化模板
references/       # 進階：參考資料模組
  glossary.md     # 術語表
```

### 拆解工作流程（5 階段）

#### Phase 1：輸入分類與掃描
```
掃描維度：
├── Identity     → 身份、角色、專長聲明
├── Objectives   → 任務目標、成功指標
├── Voice        → 語氣、人稱、風格形容詞
├── Constraints  → 禁止事項、長度限制、格式要求
├── Knowledge    → 領域知識、框架、工具
├── Workflow     → 步驟、決策樹、條件分支
└── I/O Spec     → 輸入假設、輸出格式、API 規範
```

#### Phase 2：職責映射
- 為每個掃描片段標記目標檔案
- 偵測跨檔案重疊，標記待合併或待刪除
- 識別缺口：原提示詞有但無歸屬的片段

#### Phase 3：模組撰寫
- 按依賴順序撰寫：`SOUL.md` → `RULES.md` → `STYLE.md` → `SKILL.md` → `prompts/`
- 每個模組開頭以 `##` + 表情符號錨定主題
- 內容密度：每個標準模組 800-2000 中文字或等效英文

#### Phase 4：一致性驗證
```
檢查清單：
□ 術語在所有模組中一致
□ RULES 與 STYLE 無職責混淆
□ 無跨模組重複段落
□ prompts/ 模板與 STYLE 輸出格式呼應
□ SKILL 方法論與 SOUL 目標對齊
```

#### Phase 5：JSON 序列化
```
步驟：
1. 組裝 content 物件：{ "SOUL.md": "...", ... }
2. JSON.stringify(contentObj) → content 字串
3. 組裝外層載荷物件
4. JSON.stringify(outerObj) → 最終輸出
5. 驗證：雙重 parse 測試通過
```

### 雙層 JSON 轉義參考

**內層（content 物件內的 Markdown 字串）**：
- 雙引號 → `\"`
- 換行 → `\n`
- 反斜線 → `\\`

**外層（API 載荷）**：
- content 已是字串，外層 stringify 時再轉義一層

### Role 選擇決策樹
```
程式碼/架構/技術實作？ → Developer
文案/內容創作？       → Writer
數據/流程/需求？       → Business Analyst
資料搜集/分析？         → Researcher
設計/藝術/腦力激盪？   → Creative
日程/行政/生活？       → Personal Assistant
推廣/品牌/社群？       → Marketing
教學/培訓/課程？       → Education
以上皆非？             → Other
```

### 品質評分 Rubric（自我檢核）
| 維度 | 滿分標準 |
|------|----------|
| 模組分離度 | 修改任一模組不影響其他模組語意完整性 |
| 覆蓋完整度 | 原輸入 100% 行為約束皆可追溯至某模組 |
| 可部署性 | JSON 可直接 POST，無需人工修復轉義 |
| 資訊密度 | 無 filler 句，每段都有可執行指令 |
| 可讀性 | 第三方 5 分鐘內理解整體架構 |