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

### Ironclaw Soul 架構框架（ISA-F）

**I — Identity（身份層）** → `SOUL.md`
- 角色名稱、使命、服務對象、核心能力、工作模式、品質標準

**S — Style（表達層）** → `STYLE.md`
- 語氣、格式、在地化、場景語境切換

**A — Architecture（架構層）** → 模組目錄規劃
- 檔案清單、依賴關係、擴展點（如 `prompts/`、`references/`）

**F — Framework & Guardrails（能力與護欄）** → `SKILL.md` + `RULES.md`
- 方法論、工具、紅線、合規

### 概念診斷五問（CIMEL）
1. **Concept**：一句話核心概念是什麼？
2. **Intent**：使用者真正想完成什麼任務？
3. **Market**：目標用戶是誰？專業程度？
4. **Edge**：有哪些邊界、禁區、合規要求？
5. **Launch**：部署場景（API、聊天、工作流、多 Agent 編排）？

### Role 對應決策樹
```
技術實作/Code Review → Developer
內容/文案/劇本 → Writer
流程/需求/ROI → Business Analyst
資料搜集/報告 → Researcher
品牌/視覺/概念 → Creative
日程/行政/整理 → Personal Assistant
增長/活動/渠道 → Marketing
教學/課程/輔導 → Education
跨域/新興/元策劃 → Other
```

### 模組拆分啟發式
| 信號 | 建議新增模組 |
|------|-------------|
| 有固定 SOP | `workflows/default.md` |
| 有領域知識庫 | `references/domain.md` |
| 有評分標準 | `rubrics/quality.md` |
| 有多場景入口 | `prompts/*.md` |
| 需工具調用 | `tools/manifest.md` |

### Compatibility 選型指南
- **Claude 3.5 Sonnet**：長文策劃、細緻規則、Nuanced Persona、JSON 結構化輸出
- **GPT-4o**：多模態、快速迭代、廣泛工具整合
- **Claude 3 Opus**：極高複雜度、多層推理、企業級合規 Soul
- **GPT-4o mini**：輕量客服、高頻低成本場景

### Ironclaw QA Checklist（交付前必跑）
- [ ] 外層 JSON 可被 `JSON.parse` 解析
- [ ] `content` 內層 JSON 可被二次解析
- [ ] `role` 屬於九選一合法值
- [ ] 模組 ≥ 3 且職責不重疊
- [ ] 每個模組有清晰 `##` 結構
- [ ] RULES 含 MUST 與 MUST NOT
- [ ] 無 harmful / 無證照偽造
- [ ] 語言全篇一致
- [ ] `title` 吸睛且 `description` 1-2 句
- [ ] `is_public` 合理（預設 1）

### 進階技法
**Persona Triangulation**：從「專家怎麼想 / 怎麼說 / 怎麼拒絕」三角度定義角色
**Negative Space Design**：明確定義 Agent「不做什麼」以收斂行為
**Prompt Layering**：System（Soul 模組）→ Developer → User 分層，避免污染
**Behavioral Unit Tests**：為關鍵規則撰寫「若用戶輸入 X，Agent 應 Y」

### 範例：高質素 vs 低質素 SOUL 開頭
✅ **高質素**：「你是 **FinSight Analyst**，專為香港中小企財務團隊服務的現金流分析助手。你的輸出必須含：假設清單、數據缺口、三種情境預測。」
❌ **低質素**：「你是一個非常聰明、樂於助人的 AI，會盡力幫助用戶解決所有財務問題。」