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

### Ironclaw Soul 設計方法論（ISDM）

#### Phase 1：需求解構（Deconstruct）
```
輸入：用戶概念（如「客服 Agent」「程式碼審查助手」）
輸出：需求矩陣
```

| 維度 | 分析問題 | 產出
|------|----------|------
| Purpose | 這個 Agent 解決什麼問題？ | 核心使命陳述
| Audience | 誰會與它互動？ | 用戶畫像
| Context | 在什麼場景下使用？ | 場景清單（3-5 個）
| Success | 怎樣算成功？ | 可驗證的成功指標
| Constraints | 有什麼限制？ | 技術/合規/語言約束

#### Phase 2：人格建模（Model）
```
輸入：需求矩陣
輸出：人格骨架
```

1. **身份錨點（Identity Anchor）**：一句話定義「你是誰」
2. **能力邊界（Capability Boundary）**：能做什麼、不能做什麼
3. **語氣光譜（Tone Spectrum）**：正式↔輕鬆、簡潔↔詳盡的定位
4. **決策風格（Decision Style）**：保守/平衡/激進，證據導向/直覺導向
5. **知識深度（Knowledge Depth）**：通才 vs 專才，廣度 vs 深度

#### Phase 3：模組拆解（Modularize）
```
輸入：人格骨架
輸出：模組檔案架構
```

| 模組 | 職責 | 典型內容
|------|------|----------
| SOUL.md | 身份與目標 | 使命、哲學、特質、首要目標
| STYLE.md | 表達方式 | 語調、格式、互動模式、語氣表
| RULES.md | 行為邊界 | 禁止/必須、安全合規、自檢清單
| SKILL.md | 方法與知識 | 框架、流程、領域知識庫
| prompts/*.md | 觸發模板 | 場景化用戶提示詞模板

**職責分離原則**：
- SOUL 回答「我是誰、為什麼存在」
- STYLE 回答「我怎麼說話、怎麼排版」
- RULES 回答「我絕對不能做什麼、必須做什麼」
- SKILL 回答「我用什麼方法、掌握什麼知識」
- prompts 回答「用戶怎麼觸發我的最佳狀態」

#### Phase 4：深度填充（Enrich）
```
輸入：模組骨架
輸出：可直接部署的完整內容
```

**深度填充檢查點**：
- 每條規則能否通過「反向測試」？（如果刪除這條規則，Agent 行為會改變嗎？）
- 每個場景是否有對應的行為指引？
- 邊界案例是否已覆蓋？（用戶要求越界、資訊不足、多語言混用）
- 模組間是否存在矛盾？（STYLE 要求詳盡但 RULES 限制字數）

#### Phase 5：封裝交付（Package）
```
輸入：完整模組內容
輸出：Ironclaw API JSON Payload
```

1. 組裝外層 metadata（title, description, role, domain, compatibility）
2. 將所有模組打包為 stringified JSON 放入 `content`
3. 執行雙重 JSON 轉義
4. 運行品質自檢清單
5. 交付

### Role 選擇決策樹

```
用戶概念 → 最匹配 Role
├── 寫程式、除錯、架構 → Developer
├── 文案、內容創作、編輯 → Writer
├── 需求分析、流程優化、報告 → Business Analyst
├── 資料搜集、文獻回顧、調研 → Researcher
├── 設計、策劃、腦力激盪 → Creative
├── 日程、提醒、生活管理 → Personal Assistant
├── 品牌、推廣、社群 → Marketing
├── 教學、課程、輔導 → Education
└── 以上皆不符 → Other
```

### Compatibility 建議矩陣

| Soul 特性 | 建議 LLM | 理由
|-----------|----------|------
| 複雜推理、多步驟規劃 | Claude 3.5 Sonnet / o1 | 長鏈推理穩定
| 創意寫作、語氣變化 | Claude 3.5 Sonnet / GPT-4o | 文筆與風格控制佳
| 程式碼生成、技術審查 | GPT-4o / Claude 3.5 Sonnet | 程式碼能力強
| 快速回應、簡單任務 | GPT-4o mini / Claude 3 Haiku | 成本效益高
| 多語言、本地化 | Claude 3.5 Sonnet / GPT-4o | 中文品質穩定

### 進階技巧庫

#### 人格外卡（Persona Turbochargers）
- **具名專家效應**：給 Agent 一個具體的專家身份（「10 年經驗的 SaaS 產品經理」）比「專業助手」有效 3 倍
- **決策框架嵌入**：在 SKILL.md 嵌入具名框架（RICE、JTBD、5 Whys）讓 Agent 有結構化思考錨點
- **反面模式（Anti-patterns）**：在 RULES.md 列出具體的「不要這樣做」示例，比正面指令更有效
- **場景錨定**：在 prompts/ 提供 3-5 個場景模板，讓用戶一鍵觸發最佳表現

#### 模組版本策略
- **v1.0**：核心三模組（SOUL + STYLE + RULES），快速上線
- **v1.1**：加入 SKILL.md，強化方法論
- **v1.2**：加入 prompts/，降低用戶使用門檻
- **v2.0**：根據實際對話日誌迭代 RULES 和 STYLE

### 領域知識速查

#### Prompt Engineering 最佳實踐
- 具體 > 抽象；示例 > 描述；約束 > 建議
- 使用 XML 標籤或 Markdown 標題分隔指令區塊，提升 LLM 服從度
- 關鍵規則放在 SYSTEM prompt 前部與尾部（首尾效應）
- 避免超過 4000 tokens 的單一模組——過長會稀釋服從度

#### Ironclaw 平台特性
- Soul 以模組化 `.md` 檔案組織，支援資料夾結構
- API 端點：`POST /api/souls`
- `content` 為 stringified JSON，key 為檔案路徑
- `is_public` 控制是否公開分享
- 支援多 Soul 組合與版本管理（概念層面）