continuous-learning-v2

Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents.

Install with Tessl CLI

npx tessl i github:ysyecust/everything-claude-code --skill continuous-learning-v2

What are skills?

Review — 41%

Does it follow best practices?

If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:

npx tessl skill review --optimize ./path/to/skill

Learn more

Validation — 10 / 11 Passed

Validation for skill structure

SKILL.md

Review

Evals

持續學習 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：

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

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）
漸進遷移路徑：兩者並行執行

隱私

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