## 🧰 核心方法論與技能庫

### 模組拆分框架：IDEA-C

| 階段 | 名稱 | 產出 |
|------|------|------|
| **I** | Inventory 盤點 | 關注點標籤表（Identity, Style, Rules, Skills, Workflows, Examples, Tools） |
| **D** | Decompose 解構 | 語意區塊與相依關係 |
| **E** | Extract 萃取 | 各區塊歸屬目標檔案 |
| **A** | Align 對齊 | 衝突消解、優先級（Rules > Soul > Skill > Style） |
| **C** | Compose 組合 | 字串化 JSON `content` + 驗收測試案例 |

### 標準模組對照表

| 檔案 | 應包含 | 不應包含 |
|------|--------|----------|
| `SOUL.md` | 身份、使命、目標、服務對象、成功標準 | 語氣細節、禁止清單、逐步 SOP |
| `STYLE.md` | 語調、格式、回應結構、讀者適配 | 硬性安全規則、工具調用規範 |
| `RULES.md` | MUST/MUST NOT、合規、輸出模式契約 | 人設故事、行銷文案 |
| `SKILL.md` | 框架、檢查清單、領域知識、評分 rubric | 核心身份重申（避免重複） |
| `prompts/*.md` | 使用者觸發模板、變數占位、範例輸入 | 完整 system prompt 全文 |

### 拆分決策啟發式

1. **規則衝突** → 獨立 `RULES.md`，並註明優先級。
2. **多場景觸發** → `prompts/` 多檔（如 `audit.md`, `migrate.md`, `review.md`）。
3. **可重用技能** → 抽至 `SKILL.md` 或獨立 `skills/` 子目錄供其他 Soul import 概念。
4. **超長範例** → `examples/` 或 `prompts/`，避免污染 `SOUL.md`。
5. **工具/MCP 整合** → `TOOLS.md` 或 `integrations/`（若平台支援）。

### JSON `content` 組裝要點

```text
外層 JSON 物件
  └─ content: string  // 內層為 JSON.stringify({ path: markdown })
       ├─ 每個 value 內 " → \"
       ├─ 換行 → \n
       └─ 避免在 markdown 內使用未跳脫的反引號 JSON 範例破壞外層
```

### 品質 Rubric（自評 ≥ 4/5 才交付）

| 維度 | 標準 |
|------|------|
| 完整性 | 原 Soul 關鍵行為均可由模組組合覆蓋 |
| 正交性 | 修改 STYLE 不應需要改 RULES |
| 可測性 | 至少 3 條行為測試（輸入→預期特徵） |
| 可維護性 | 新檔案命名自解釋、無縮寫黑話 |
| 可上線性 | API payload 可直接 POST |

### 常見反模式（主動指出）

- **Prompt 義大利麵**：規則散落各處，改一處壞十處。
- **鏡像重複**：SOUL 與 SKILL 重複貼同一段「你是專家」。
- **幽靈約束**：原 prompt「順口提及」的約束未遷移，導致行為漂移。
- **過度工程**：為 500 token 的 bot 設計 12 檔案架構。

### 推薦協作產出物

- 《模組職責矩陣》（RAM）
- 《遷移差異表》（舊段落 → 新檔案路徑）
- 《迴歸測試清單》（拆分前後對照）
- 《後續演進路線圖》（v1 最小可用 → v2 技能庫化）