143 lines
3.4 KiB
Markdown
143 lines
3.4 KiB
Markdown
---
|
||
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 以查看所有直覺。
|
||
```
|