Everything Claude Code连续学习系统v2.1：如何让AI从你的开发会话中自主学习

【免费下载链接】everything-claude-code Complete Claude Code configuration collection - agents, skills, hooks, commands, rules, MCPs. Battle-tested configs from an Anthropic hackathon winner. 项目地址: https://gitcode.com/GitHub_Trending/ev/everything-claude-code

Everything Claude Code连续学习系统v2.1是一个基于本能的学习系统，它通过钩子观察开发会话，创建具有置信度评分的原子本能，并将其演化为技能、命令和代理。v2.1版本新增了项目范围的本能，可防止跨项目污染，让AI能够从你的开发会话中自主学习。

🌟 v2.1版本的核心改进

v2.1版本带来了多项重要更新，其中最关键的是引入了项目范围的本能管理。这一功能解决了不同项目间代码风格和规范可能冲突的问题，让React模式保留在React项目中，Python约定保留在Python项目中，而像"始终验证输入"这样的通用模式则可以全局共享。

特性	v2.0	v2.1
存储	全局 (~/.claude/homunculus/)	项目范围 (projects/ /)
范围	所有本能适用于所有地方	项目范围 + 全局
检测	无	git远程URL / 仓库路径
升级	不适用	当在2+项目中出现时，从项目升级到全局
命令	4个（状态/进化/导出/导入）	6个（+升级/项目）
跨项目	有污染风险	默认隔离

🧠 本能模型解析

本能是一种小型的学习行为，具有以下特点：

• 原子性 - 一个触发条件，一个行动
• 置信度加权 - 0.3 = 暂定，0.9 = 几乎确定
• 领域标记 - 代码风格、测试、git、调试、工作流等
• 证据支持 - 跟踪创建它的观察结果
• 范围感知 - project（默认）或global

本能示例：

---
id: prefer-functional-style
trigger: "when writing new functions"
confidence: 0.7
domain: "code-style"
source: "session-observation"
scope: project
project_id: "a1b2c3d4e5f6"
project_name: "my-react-app"
---

# 偏好函数式风格

## 行动
在适当的时候使用函数式模式而不是类。

## 证据
- 观察到5个函数式模式偏好的实例
- 用户在2025-01-15将基于类的方法更正为函数式

🔄 连续学习工作流程

Everything Claude Code连续学习系统v2.1的工作流程如下：

1. 会话活动（在git仓库中）
2. 钩子捕获提示+工具使用（100%可靠）+检测项目上下文（git远程/仓库路径）
3. 存储观察结果到projects/ /observations.jsonl
4. 观察者代理（后台运行，使用Haiku模型）读取并分析观察结果
5. 模式检测：用户更正→本能、错误解决→本能、重复工作流→本能、范围决策
6. 创建/更新本能到项目范围或全局范围的本能存储
7. 进化和升级：通过/evolve命令聚类本能，通过/promote命令升级项目本能到全局范围

多会话并行学习示意图：通过终端并行运行多个Claude实例，系统会在需要输入时通过通知提醒用户

🚀 快速开始指南

1. 启用观察钩子

将以下配置添加到你的~/.claude/settings.json文件中：

如果作为插件安装（推荐）：

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

如果手动安装到~/.claude/skills：

{
  "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},projects}

# 项目目录在git仓库中首次运行钩子时自动创建

会话存储示例：显示.claude目录结构，包括hooks、plugins和sessions文件夹，以及具体的会话文件

3. 使用本能命令

/instinct-status     # 显示已学习的本能（项目+全局）
/evolve              # 将相关本能聚类为技能/命令
/instinct-export     # 将本能导出到文件
/instinct-import     # 从他人导入本能
/promote             # 将项目本能升级到全局范围
/projects            # 列出所有已知项目及其本能数量

💻 核心命令详解

命令	描述
/instinct-status	显示所有本能（项目范围+全局）及置信度
/evolve	将相关本能聚类为技能/命令，建议升级
/instinct-export	导出本能（可按范围/领域筛选）
/instinct-import <file>	导入本能并控制范围
/promote [id]	将项目本能升级到全局范围
/projects	列出所有已知项目及其本能数量

命令链表示例：展示在开发会话中如何链式使用/refactor-clean、/test-coverage和/e2e命令，系统会自动记录这些操作作为学习素材

📁 文件结构

~/.claude/homunculus/
+-- identity.json           # 你的个人资料，技术水平
+-- projects.json           # 注册表：项目哈希 -> 名称/路径/远程
+-- observations.jsonl      # 全局观察结果（备用）
+-- instincts/
|   +-- personal/           # 全局自动学习的本能
|   +-- inherited/          # 全局导入的本能
+-- evolved/
|   +-- agents/             # 全局生成的代理
|   +-- skills/             # 全局生成的技能
|   +-- commands/           # 全局生成的命令
+-- projects/
    +-- a1b2c3d4e5f6/       # 项目哈希（来自git远程URL）
    |   +-- project.json    # 每个项目的元数据镜像（id/名称/根目录/远程）
    |   +-- observations.jsonl
    |   +-- observations.archive/
    |   +-- instincts/
    |   |   +-- personal/   # 项目特定的自动学习
    |   |   +-- inherited/  # 项目特定的导入
    |   +-- evolved/
    |       +-- skills/
    |       +-- commands/
    |       +-- agents/
    +-- f6e5d4c3b2a1/       # 另一个项目
        +-- ...

🔍 范围决策指南

模式类型	范围	示例
语言/框架约定	项目	"使用React hooks"，"遵循Django REST模式"
文件结构偏好	项目	"测试在__tests__/中"，"组件在src/components/"
代码风格	项目	"使用函数式风格"，"偏好数据类"
错误处理策略	项目	"使用Result类型处理错误"
安全实践	全局	"验证用户输入"，"净化SQL"
一般最佳实践	全局	"先写测试"，"始终处理错误"
工具工作流偏好	全局	"编辑前先Grep"，"写入前先阅读"
Git实践	全局	"规范提交"，"小而专注的提交"

📈 本能升级（项目→全局）

当相同的本能出现在多个项目中且具有高置信度时，它有资格升级到全局范围。

自动升级标准：

• 在2+项目中出现相同的本能ID
• 平均置信度≥0.8

如何升级：

# 升级特定本能
python3 instinct-cli.py promote prefer-explicit-errors

# 自动升级所有符合条件的本能
python3 instinct-cli.py promote

# 预览而不进行更改
python3 instinct-cli.py promote --dry-run

📊 置信度评分

置信度会随着时间演变：

分数	含义	行为
0.3	暂定	建议但不强制执行
0.5	中等	相关时应用
0.7	强	自动批准应用
0.9	几乎确定	核心行为

置信度增加当：

• 模式被反复观察
• 用户没有纠正建议的行为
• 来自其他来源的类似本能一致

置信度降低当：

• 用户明确纠正行为
• 长时间未观察到模式
• 出现矛盾的证据

🔒 隐私保护

• 观察结果本地保存在你的机器上
• 项目范围的本能按项目隔离
• 只有本能（模式）可以导出——不是原始观察结果
• 不共享实际代码或对话内容
• 你控制导出和升级的内容

🛠️ 配置选项

编辑config.json以控制后台观察者：

{
  "version": "2.1",
  "observer": {
    "enabled": false,
    "run_interval_minutes": 5,
    "min_observations_to_analyze": 20
  }
}

键	默认值	描述
observer.enabled	false	启用后台观察者代理
observer.run_interval_minutes	5	观察者分析观察结果的频率
observer.min_observations_to_analyze	20	分析运行前的最小观察数

其他行为（观察捕获、本能阈值、项目范围、升级标准）通过instinct-cli.py和observe.sh中的代码默认值配置。

📚 相关资源

• ECC-Tools GitHub App - 从仓库历史生成本能
• Homunculus - 启发v2本能架构的社区项目（原子观察、置信度评分、本能进化管道）
• The Longform Guide - 连续学习部分

通过Everything Claude Code连续学习系统v2.1，你的AI助手可以从你的开发会话中不断学习和适应，成为真正符合你个人编码风格和项目需求的得力助手。无论是项目特定的编码规范还是通用的最佳实践，系统都能智能捕获并应用，让你的开发过程更加高效和愉悦。

要开始使用，只需克隆仓库并按照快速开始指南进行配置：

git clone https://gitcode.com/GitHub_Trending/ev/everything-claude-code

基于本能的学习：一次一个项目，教Claude你的模式。

【免费下载链接】everything-claude-code Complete Claude Code configuration collection - agents, skills, hooks, commands, rules, MCPs. Battle-tested configs from an Anthropic hackathon winner. 项目地址: https://gitcode.com/GitHub_Trending/ev/everything-claude-code