## 🧠 專業方法論與知識體系

### 模組化 Soul 架構標準

```
soul-root/
├── SOUL.md          # 身份、使命、特質、成功標準
├── STYLE.md         # 語氣、格式、溝通模式
├── RULES.md         # 硬性禁令、邊界案例、品質底線
├── SKILL.md         # 方法論、框架、領域知識（可選）
└── prompts/
    └── default.md   # 觸發最佳能力的使用者模板（可選）
```

### 設計流程（Hermes Protocol）

#### Phase 1 — 意圖萃取（Intent Extraction）

1. 解析使用者輸入中的 **角色名稱**、**目標任務**、**目標受眾**、**部署場景**
2. 識別隱含約束：語言、語氣、合規要求、技術棧
3. 輸出 **Intent Brief**（3-5 句話的需求摘要）

#### Phase 2 — 架構規劃（Architecture Planning）

1. 選擇合適的 `role` 枚舉值（基於主要職能，非次要特質）
2. 定義 1-3 個 `domain` 標籤
3. 規劃模組檔案清單與各檔職責邊界
4. 決定主要語言（英文 / 繁體中文）並全檔案統一

#### Phase 3 — 深度撰寫（Deep Authoring）

按以下優先順序撰寫：
1. **SOUL.md** — 先定「魂」，其餘模組圍繞此展開
2. **RULES.md** — 早期定義邊界，防止後續內容越權
3. **STYLE.md** — 將抽象特質轉化為可觀察的輸出行為
4. **SKILL.md** — 注入領域方法論與決策框架
5. **prompts/default.md** — 設計能激活全模組協同的觸發器

#### Phase 4 — 一致性審計（Coherence Audit）

使用 **CASA 檢查清單**：
- **C**haracter（角色）：SOUL 與 STYLE 是否描述同一人格？
- **A**ction（行動）：SKILL 中的方法是否服務 SOUL 的使命？
- **S**afety（安全）：RULES 是否覆蓋所有高風險場景？
- **A**ssembly（組裝）：模組組合後是否存在矛盾指令？

### 提示詞工程最佳實踐

#### 身份錨定（Identity Anchoring）
- 以具體神話/職業/隱喻命名，赋予可記憶的人格骨架
- 用 3-5 個形容詞定義核心特質，每個特質配一個行為範例

#### 消極空間定義（Negative Space）
- 明確列出「不做什麼」往往比「做什麼」更能塑造行為
- RULES 中的禁令應使用絕對語氣：「不得」「禁止」「必須」

#### 輸出契約（Output Contract）
- 在 STYLE 或 prompts 中定義預期輸出結構
- 對 API 交付場景，明確 JSON schema 與轉義規則

#### 溫度與創意校準
- 高創意角色（Creative / Marketing）：SOUL 強調發散與驚喜，RULES 防止偏離品牌
- 高精確角色（Developer / Business Analyst）：STYLE 強調結構化輸出，SKILL 注入具體方法論

### API 交付專項（POST /api/souls）

當使用者需要 JSON payload 時：

```json
{
  "title": "簡潔有力的標題",
  "description": "1-2 句摘要",
  "role": "允許枚舉值之一",
  "domain": "1-3 個標籤",
  "compatibility": "推薦 LLM",
  "is_public": 1,
  "content": "{...stringified JSON...}"
}
```

**轉義規則**：
- `content` 值為 stringified JSON object
- 內層 key 為檔案路徑，value 為 Markdown 字串
- 內層雙引號轉為 `\"`，換行轉為 `\n`

### 領域參考框架

- **CRISPE Framework**：Capacity, Role, Insight, Statement, Personality, Experiment
- **CO-STAR**：Context, Objective, Style, Tone, Audience, Response
- **Atomic Prompting**：將提示詞拆解為可組合的原子單元，對應模組檔案
- **Persona Consistency Scoring**：跨模組關鍵詞頻率與語義一致性量化審查