affaan-m/continuous-learning-v2

持續學習 v2 - 基於本能的架構

進階學習系統，透過原子「本能」（帶信心評分的小型學習行為）將你的 Claude Code 工作階段轉化為可重用知識。

v2 的新功能

| 功能 | v1 | v2 | |------|----|----| | 觀察 | Stop hook（工作階段結束） | PreToolUse/PostToolUse（100% 可靠） | | 分析 | 主要上下文 | 背景 agent（Haiku） | | 粒度 | 完整技能 | 原子「本能」 | | 信心 | 無 | 0.3-0.9 加權 | | 演化 | 直接到技能 | 本能 → 聚類 → 技能/指令/agent | | 分享 | 無 | 匯出/匯入本能 |

本能模型

本能是一個小型學習行為：

---
id: prefer-functional-style
trigger: "when writing new functions"
confidence: 0.7
domain: "code-style"
source: "session-observation"
---

# 偏好函式風格

## 動作
適當時使用函式模式而非類別。

## 證據
- 觀察到 5 次函式模式偏好
- 使用者在 2025-01-15 將基於類別的方法修正為函式

屬性：

• 原子性 — 一個觸發器，一個動作
• 信心加權 — 0.3 = 試探性，0.9 = 近乎確定
• 領域標記 — code-style、testing、git、debugging、workflow 等
• 證據支持 — 追蹤建立它的觀察

運作方式

工作階段活動
      │
      │ Hooks 捕獲提示 + 工具使用（100% 可靠）
      ▼
┌─────────────────────────────────────────┐
│         observations.jsonl              │
│   （提示、工具呼叫、結果）               │
└─────────────────────────────────────────┘
      │
      │ Observer agent 讀取（背景、Haiku）
      ▼
┌─────────────────────────────────────────┐
│          模式偵測                        │
│   • 使用者修正 → 本能                   │
│   • 錯誤解決 → 本能                     │
│   • 重複工作流程 → 本能                 │
└─────────────────────────────────────────┘
      │
      │ 建立/更新
      ▼
┌─────────────────────────────────────────┐
│         instincts/personal/             │
│   • prefer-functional.md (0.7)          │
│   • always-test-first.md (0.9)          │
│   • use-zod-validation.md (0.6)         │
└─────────────────────────────────────────┘
      │
      │ /evolve 聚類
      ▼
┌─────────────────────────────────────────┐
│              evolved/                   │
│   • commands/new-feature.md             │
│   • skills/testing-workflow.md          │
│   • agents/refactor-specialist.md       │
└─────────────────────────────────────────┘

快速開始

1. 啟用觀察 Hooks

如果作為外掛安裝（建議）：

不需要在 ~/.claude/settings.json 中額外加入 hook。Claude Code v2.1+ 會自動載入外掛的 hooks/hooks.json，其中已經註冊了 observe.sh。

如果你之前把 observe.sh 複製到 ~/.claude/settings.json，請移除重複的 PreToolUse / PostToolUse 區塊。重複註冊會造成重複執行，並觸發 ${CLAUDE_PLUGIN_ROOT} 解析錯誤；這個變數只會在外掛自己的 hooks/hooks.json 中展開。

如果手動安裝到 ~/.claude/skills，新增到你的 ~/.claude/settings.json：

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh"
      }]
    }],
    "PostToolUse": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/skills/continuous-learning-v2/hooks/observe.sh"
      }]
    }]
  }
}

2. 初始化目錄結構

mkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands}}
touch ~/.claude/homunculus/observations.jsonl

3. 執行 Observer Agent（可選）

觀察者可以在背景執行並分析觀察：

# 啟動背景觀察者
~/.claude/skills/continuous-learning-v2/agents/start-observer.sh

指令

| 指令 | 描述 | |------|------| | /instinct-status | 顯示所有學習本能及其信心 | | /evolve | 將相關本能聚類為技能/指令 | | /instinct-export | 匯出本能以分享 | | /instinct-import <file> | 從他人匯入本能 |

設定

編輯 config.json：

{
  "version": "2.0",
  "observation": {
    "enabled": true,
    "store_path": "~/.claude/homunculus/observations.jsonl",
    "max_file_size_mb": 10,
    "archive_after_days": 7
  },
  "instincts": {
    "personal_path": "~/.claude/homunculus/instincts/personal/",
    "inherited_path": "~/.claude/homunculus/instincts/inherited/",
    "min_confidence": 0.3,
    "auto_approve_threshold": 0.7,
    "confidence_decay_rate": 0.05
  },
  "observer": {
    "enabled": true,
    "model": "haiku",
    "run_interval_minutes": 5,
    "patterns_to_detect": [
      "user_corrections",
      "error_resolutions",
      "repeated_workflows",
      "tool_preferences"
    ]
  },
  "evolution": {
    "cluster_threshold": 3,
    "evolved_path": "~/.claude/homunculus/evolved/"
  }
}

檔案結構

~/.claude/homunculus/
├── identity.json           # 你的個人資料、技術水平
├── observations.jsonl      # 當前工作階段觀察
├── observations.archive/   # 已處理觀察
├── instincts/
│   ├── personal/           # 自動學習本能
│   └── inherited/          # 從他人匯入
└── evolved/
    ├── agents/             # 產生的專業 agents
    ├── skills/             # 產生的技能
    └── commands/           # 產生的指令

與 Skill Creator 整合

當你使用 Skill Creator GitHub App 時，它現在產生兩者：

• 傳統 SKILL.md 檔案（用於向後相容）
• 本能集合（用於 v2 學習系統）

從倉庫分析的本能有 source: "repo-analysis" 並包含來源倉庫 URL。

信心評分

信心隨時間演化：

| 分數 | 意義 | 行為 | |------|------|------| | 0.3 | 試探性 | 建議但不強制 | | 0.5 | 中等 | 相關時應用 | | 0.7 | 強烈 | 自動批准應用 | | 0.9 | 近乎確定 | 核心行為 |

信心增加當：

• 重複觀察到模式
• 使用者不修正建議行為
• 來自其他來源的類似本能同意

信心減少當：

• 使用者明確修正行為
• 長期未觀察到模式
• 出現矛盾證據

為何 Hooks vs Skills 用於觀察？

"v1 依賴技能進行觀察。技能是機率性的——它們根據 Claude 的判斷觸發約 50-80% 的時間。"

Hooks 100% 的時間確定性地觸發。這意味著：

• 每個工具呼叫都被觀察
• 無模式被遺漏
• 學習是全面的

向後相容性

v2 完全相容 v1：

• 現有 ~/.claude/skills/learned/ 技能仍可運作
• Stop hook 仍執行（但現在也餵入 v2）
• 漸進遷移路徑：兩者並行執行

隱私

• 觀察保持在你的機器本機
• 只有本能（模式）可被匯出
• 不會分享實際程式碼或對話內容
• 你控制匯出內容

相關

• Skill Creator - 從倉庫歷史產生本能
• Homunculus - 啟發 v2 架構的社區專案（原子觀察、信心評分、本能演化管線）
• Longform Guide - 持續學習章節

---

基於本能的學習：一次一個觀察，教導 Claude 你的模式。