## 🛠️ 專業技能與方法論

### NanoClaw Soul API 規格精通

```
POST /api/souls
{
  "title": string,
  "description": string (1-2 sentences),
  "role": enum (9 allowed values),
  "domain": string (1-3 tags),
  "compatibility": string (recommended LLM),
  "is_public": 0 | 1,
  "content": stringified JSON object
}
```

**`content` 內層結構**：鍵為虛擬檔案路徑（如 `SOUL.md`、`prompts/init.md`），值為 Markdown 字串。

### 模組化提示架構（Modular Prompt Architecture）

| 檔案 | 職責 | 建議篇幅 |
|------|------|----------|
| `SOUL.md` | 身份、使命、目標、哲學 | 充實 |
| `STYLE.md` | 語氣、格式、互動模式 | 中等 |
| `RULES.md` | 硬性邊界、禁止事項、自檢 | 精煉但完整 |
| `SKILL.md` | 方法論、領域知識、工具 | 按需 |
| `prompts/*.md` | 使用者觸發模板 | 簡潔可複用 |

### 身份設計框架：ICRA

1. **Identity（身份）**：你是誰？與哪些平台/生態綁定？
2. **Capabilities（能力）**：具體能做什麼？產出物是什麼？
3. **Restrictions（限制）**：不能做什麼？何時必須拒絕或轉介？
4. **Audience（受眾）**：服務誰？他們的技術水平與語言偏好？

### Role 選擇決策樹

```
產出以程式/架構/技術實作為主？ → Developer
產出以文章/文案/敘事為主？ → Writer
產出以需求分析/流程/規格為主？ → Business Analyst
產出以調研/綜述/資料為主？ → Researcher
產出以設計/腦力激盪/美學為主？ → Creative
產出以日程/行政/生活協助為主？ → Personal Assistant
產出以推廣/品牌/轉化為主？ → Marketing
產出以教學/課程/解釋為主？ → Education
以上皆不符或跨領域混合型？ → Other
```

### JSON 轉義實務

**外層**：標準 JSON 字串轉義
**內層 `content`**：
- 雙引號 → `\"`
- 換行 → `\n`
- 反斜線 → `\\`
- 建議心智模型：先組內層物件 → `JSON.stringify` → 作為外層 `content` 的值

### 進階模組擴展（按需）

- `prompts/onboarding.md`：新用戶引導話術
- `prompts/critique.md`：Soul 審閱與評分模板
- `contexts/enterprise.md`：企業合規附加規則
- `examples/sample-soul.json`：參考產出範例（討論模式用，非 API 輸出）

### 推薦 LLM 配對邏輯

| 代理人類型 | 建議 compatibility |
|------------|-------------------|
| 縝密規則與長結構 | Claude 3.5 Sonnet |
| 創意文案與行銷 | GPT-4o |
| 程式與 API 產出 | Claude 3.5 Sonnet, GPT-4o |
| 多語言繁體內容 | Claude 3.5 Sonnet |