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

### Ironclaw Soul 模組標準架構
```
SOUL.md          → 身份、使命、成功標準
STYLE.md         → 語氣、輸出模式、格式
RULES.md         → MUST / MUST NOT、API 契約
SKILL.md         → 方法論、檢核表、範式
prompts/default.md → 使用者觸發模板
```

### 生產級 Soul 設計流程（6 步）
1. **Intake**：萃取目標使用者、任務類型、風險等級、目標 LLM。
2. **Role Mapping**：將職能映射到 9 個合法 role 之一。
3. **Module Decomposition**：用關注點分離拆模組，避免「萬能檔」。
4. **Constraint Layering**：先寫 RULES（硬），再寫 STYLE（軟），最後 SOUL（魂）。
5. **Escape & Validate**：建構 stringified JSON，做雙層解析測試。
6. **Trigger Design**：撰寫 `prompts/default.md`，確保首次對話即進入最佳上下文。

### JSON 雙層逃逸檢核表
- [ ] 外層：`JSON.parse(payload)` 成功
- [ ] 內層：`JSON.parse(payload.content)` 成功
- [ ] 內層每個 key 為合法路徑字串
- [ ] 內層 value 中無未逃逸的 raw 雙引號
- [ ] 換行均以 `\n` 表示，無實際換行破壞外層字串

### Persona 設計模式庫
| 模式 | 適用 | 要點 |
|------|------|------|
| **Expert Operator** | 開發/維運類 | 強調檢核、rollback、可觀測性 |
| **Creative Director** | 創意/行銷類 | STYLE 厚、RULES 重版權與品牌安全 |
| **Research Analyst** | 研究類 | SKILL 含引用規範、不確定性標記 |
| **Tutor Coach** | 教育類 | 循序提問、掌握度追蹤語句 |
| **Chief of Staff** | 助理類 | prompts 含情境模板（會議/郵件/行程） |

### LLM 相容性調校備忘
- **Claude 系列**：結構化 Markdown、明確分段、長文規則放 RULES 末尾。
- **GPT-4o 系列**：清單化步驟、範例驅動（few-shot 放在 SKILL 或 prompts）。
- **通用**：避免過度否定句堆疊；以「做什麼」取代「不要做什麼」的無限列表。

### 品質指標（建議內建於每個 Soul）
- **Determinism**：同輸入下輸出結構穩定
- **Auditability**：模組可獨立審查
- **Composability**：可增加 `prompts/` 子模板而不改核心
- **Safety**：邊界清晰、拒絕路徑明確

### 交付前 Self-Review 問題
1. 若我只讀 `description` + `prompts/default.md`，能否在 30 秒內知道怎麼用？
2. RULES 是否足以防止最危險的误用？
3. 是否存在跨模組重複段落可刪除？
4. 此 Soul 在 API 模式是否會意外輸出多餘文字？