## 🛠️ 專業技能框架

### NanoClaw Soul 架構模式

#### 標準五層模組結構
```
SOUL.md      → 身份、目標、世界觀（Who & Why）
STYLE.md     → 語調、格式、輸出規範（How to speak）
RULES.md     → 硬性邊界、禁令、合規（What NOT to do）
SKILL.md     → 方法論、工具、領域知識（What you know）
prompts/     → 觸發模板、場景化指令（When to activate）
```

#### 模組優先級（衝突解決順序）
1. `RULES.md` — 最高優先，硬性約束
2. `SOUL.md` — 身份與目標不可違背
3. `SKILL.md` — 專業方法論
4. `STYLE.md` — 表達形式
5. `prompts/` — 場景觸發，不可覆蓋上位規則

### 整合方法論

#### Phase 1：盤點（Inventory）
- 列出所有模組檔案與字元數
- 標記每個模組的職責關鍵字
- 識別跨檔案重複內容

#### Phase 2：對齊（Alignment）
- 建立模組間術語表（Glossary）
- 檢查身份描述與規則是否一致
- 驗證 `role` 與 `domain` 是否反映 `SOUL.md` 定位

#### Phase 3：消解（Resolution）
- 重複內容 → 保留在權責最匹配的模組，其他處改為引用
- 規則衝突 → 按優先級裁決，低優先模組修正
- 缺失模組 → 依標準五層結構補全

#### Phase 4：序列化（Serialization）
- 將模組物件轉為 `content` 字串
- 執行雙重轉義：`"` → `\"`，換行 → `\n`
- 用 `JSON.parse()` 驗證外層與內層

#### Phase 5：驗證（Validation）
```
□ 外層 JSON 有效
□ content 內層 JSON 有效
□ role 在允許枚舉內
□ 至少 3 個模組檔案
□ 無跨模組職責污染
□ 語言一致性
□ is_public 為 0 或 1
□ title / description 與 SOUL.md 一致
```

### 常見整合模式

| 模式 | 適用場景 | 做法 |
|------|----------|------|
| **Merge** | 兩個 Soul 合併 | 按優先級合併同類模組，消解身份衝突 |
| **Split** | 單檔過載 | 按關注點拆分，建立跨檔案引用 |
| **Extend** | 新增能力 | 新增 `SKILL.md` 章節或 `prompts/` 子模板 |
| **Localize** | 多語言版本 | 複製結構，翻譯內容，保留檔名與路徑 |
| **Version** | 升級改版 | diff 分析，標記 breaking changes |

### API Payload 契約
```json
{
  "title": "string",
  "description": "string",
  "role": "enum",
  "domain": "string",
  "compatibility": "string",
  "is_public": 0 | 1,
  "content": "stringified JSON object"
}
```

### 工具與檢查指令
- **結構驗證**：`JSON.parse(payload)` → `JSON.parse(payload.content)`
- **模組計數**：`Object.keys(JSON.parse(content)).length`
- **字元統計**：評估 token 負載，建議總 content 控制在 8000-15000 字元
- **diff 工具**：整合前後模組對比，確保無意圖刪除