---
name: instinct-import
description: 從隊友、Skill Creator 或其他來源匯入直覺 (Instincts)
command: true
---

# 直覺匯入指令 (Instinct Import Command)

## 實作方式

使用外掛程式根路徑執行直覺 CLI：

```bash
python3 "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/scripts/instinct-cli.py" import <file-or-url> [--dry-run] [--force] [--min-confidence 0.7]
```

或者，如果未設定 `CLAUDE_PLUGIN_ROOT` (手動安裝)：

```bash
python3 ~/claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file-or-url>
```

匯入來源：
- 隊友的匯出檔
- Skill Creator (儲存庫分析)
- 社群集合
- 先前機器的備份

## 使用方式

```
/instinct-import team-instincts.yaml
/instinct-import https://github.com/org/repo/instincts.yaml
/instinct-import --from-skill-creator acme/webapp
```

## 操作步驟

1. 獲取直覺檔案 (本地路徑或 URL)
2. 解析並驗證格式
3. 檢查是否與現有直覺重複
4. 合併或新增直覺
5. 儲存至 `~/.claude/homunculus/instincts/inherited/`

## 匯入流程

```
📥 正在從 team-instincts.yaml 匯入直覺
================================================

找到 12 則待匯入的直覺。

正在分析衝突...

## 新直覺 (8)
這些將被新增：
  ✓ use-zod-validation (置信度: 0.7)
  ✓ prefer-named-exports (置信度: 0.65)
  ✓ test-async-functions (置信度: 0.8)
  ...

## 重複直覺 (3)
已有類似的直覺：
  ⚠️ prefer-functional-style
     本地：0.8 置信度，12 次觀察
     匯入：0.7 置信度
     → 保留本地 (置信度較高)

  ⚠️ test-first-workflow
     本地：0.75 置信度
     匯入：0.9 置信度
     → 更新為匯入內容 (置信度較高)

## 衝突直覺 (1)
這些與本地直覺相牴觸：
  ❌ use-classes-for-services
     衝突項：avoid-classes
     → 跳過 (需要手動解決)

---
匯入 8 個新項，更新 1 個，跳過 3 個？
```

## 合併策略

### 針對重複項
當匯入的直覺與現有直覺匹配時：
- **高置信度優先**：保留置信度較高的那一項
- **合併證據**：結合觀察計數
- **更新時間戳記**：標記為最近已驗證

### 針對衝突項
當匯入的直覺與現有直覺牴觸時：
- **預設跳過**：不要匯入受衝突的直覺
- **標記待審查**：將兩者都標記為需要關注
- **手動解決**：由使用者決定保留哪一項

## 來源追蹤

匯入的直覺會標記有：
```yaml
source: "inherited"
imported_from: "team-instincts.yaml"
imported_at: "2025-01-22T10:30:00Z"
original_source: "session-observation"  # 或 "repo-analysis"
```

## Skill Creator 整合

從 Skill Creator 匯入時：

```
/instinct-import --from-skill-creator acme/webapp
```

這會獲取透過儲存庫分析生成的直覺：
- 來源：`repo-analysis`
- 較高的初始置信度 (0.7+)
- 連結至來源儲存庫

## 旗標 (Flags)

- `--dry-run`：預覽而不實際匯入
- `--force`：即使存在衝突也進行匯入
- `--merge-strategy <higher|local|import>`：如何處理重複項
- `--from-skill-creator <owner/repo>`：從 Skill Creator 分析結果匯入
- `--min-confidence <n>`：僅匯入高於門檻值的直覺

## 輸出結果

匯入完成後：
```
✅ 匯入完成！

新增：8 則直覺
更新：1 則直覺
跳過：3 則直覺 (2 則重複，1 則衝突)

新直覺已儲存至：~/.claude/homunculus/instincts/inherited/

執行 /instinct-status 以查看所有直覺。
```
