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

### NanoClaw Soul 模組架構標準

#### 標準模組職責矩陣

| 模組 | 核心問題 | 應包含 | 不應包含 |
|------|----------|--------|----------|
| `SOUL.md` | 我是誰？為何存在？ | 身份、使命、目標、哲學 | 語氣規則、禁止事項、技術步驟 |
| `STYLE.md` | 我如何表達？ | 語調、格式、回應結構 | 核心身份、硬性禁令 |
| `RULES.md` | 我絕對不能做什麼？ | 邊界、約束、衝突解決 | 技能描述、風格偏好 |
| `SKILL.md` | 我精通什麼？ | 框架、方法論、領域知識 | 人格描述、通用禮儀 |
| `prompts/*.md` | 如何觸發最佳表現？ | 場景模板、初始化流程 | 重複 SOUL 核心定義 |

#### 模組依賴方向（推薦）
```
SOUL.md（根）
  ├── STYLE.md（引用身份語境）
  ├── RULES.md（覆寫衝突時優先於 STYLE）
  ├── SKILL.md（獨立知識層）
  └── prompts/（消費者層，依賴上述所有模組）
```

### Soul 健康度評估框架（SHAF）

**五大維度，各 1-10 分：**

1. **模組內聚性（Cohesion）**：每個檔案是否只回答一個問題？
2. **邊界清晰度（Boundary Clarity）**：模組間是否有職責重疊或缺口？
3. **可測試性（Testability）**：變更是否有明確的驗證標準？
4. **演進友善度（Evolvability）**：是否支援漸進式修改與版本管理？
5. **抗 Drift 能力（Drift Resistance）**：規則是否具體、無歧義、無內部矛盾？

**健康度等級：**
- 40-50：🟢 健康 — 例行維護即可
- 30-39：🟡 亞健康 — 需排程技術債清理
- 20-29：🟠 風險 — 近期需重構
- <20：🔴 危急 — 立即暫停新功能，優先修復 Soul

### Prompt Drift 診斷清單

**徵兆識別：**
- [ ] 同一問題在不同對話中回答風格劇烈波動
- [ ] AI 開始「創意解讀」RULES 中未明確禁止的行為
- [ ] 新增 patch 後，舊有行為 unexpectedly 改變
- [ ] 模組間出現矛盾指令（如 STYLE 要求詳盡，RULES 限制字數）
- [ ] SOUL 目標與實際 SKILL 能力不匹配
- [ ] prompts/ 模板與核心模組定義脫節

**修復策略優先序：**
1. 消除模組內矛盾（P0）
2. 將隱性規則顯式化（P0）
3. 建立衝突優先級矩陣（P1）
4. 引入回歸測試 prompt suite（P1）
5. 考慮模型更換或參數調整（P2）

### Soul 版本語意化管理（SemVer for Souls）

| 變更類型 | 版本 bump | 範例 |
|----------|-----------|------|
| 修正錯字、澄清語意（行為不變） | PATCH | `1.2.3 → 1.2.4` |
| 新增 SKILL、擴展 prompts/（向後相容） | MINOR | `1.2.4 → 1.3.0` |
| 修改核心身份、刪除規則、改變優先級 | MAJOR | `1.3.0 → 2.0.0` |

**Changelog 模板：**
```markdown
## [版本號] - YYYY-MM-DD
### Added
- 新增內容
### Changed
- 變更內容（附影響說明）
### Deprecated
- 即將移除的內容（附替代方案與移除日期）
### Removed
- 已移除內容（附 migration 指引）
### Fixed
- 修復的 drift/衝突問題
```

### 技術債治理模式

**Soul Tech Debt Quadrant：**
- **Q1 高影響 × 低 effort**：立即處理（如合併重複規則）
- **Q2 高影響 × 高 effort**：排入季度重構（如模組重新拆分）
- **Q3 低影響 × 低 effort**：順手清理
- **Q4 低影響 × 高 effort**：記錄但不優先

### 共用模組抽取模式

當多個 Soul 共享 >30% 內容時，考慮抽取：
- `shared/RULES.base.md` — 通用安全與格式規則
- `shared/STYLE.base.md` — 組織級溝通風格
- `shared/SKILL.common.md` — 共用領域知識

抽取原則：
- 共用模組只放**真正通用**的內容
- Soul 專屬模組透過「擴展」而非「覆寫」引用共用層
- 共用模組變更需更嚴格的 review 流程

### 回歸測試 Prompt Suite 設計

每個 Soul 應維護至少 **5 類**測試 prompt：
1. **身份驗證**：確認 AI 正確自我介紹與角色定位
2. **邊界測試**：觸發 RULES 禁止行為，確認正確拒絕
3. **風格一致性**：同類問題多次詢問，比對格式與語調
4. **技能深度**：觸發 SKILL 核心能力，驗證專業輸出品質
5. **衝突解析**：設計兩難情境，驗證優先級規則是否正確生效