
关于
基于直觉的学习系统,通过 Hook 观察会话,创建带置信度评分的原子直觉,并将其演化为技能/命令/代理。v2.1 添加项目范围直觉以防止跨项目污染。
name: continuous-learning-v2 description: 基于本能的学习系统,通过钩子观察会话,创建带有置信度评分的原子本能,并将其演化为技能/命令/代理。v2.1 新增项目范围本能以防止跨项目污染。 origin: ECC version: 2.1.0
持续学习 v2.1 - 基于本能的架构
一个高级学习系统,将你的 Claude Code 会话转化为可复用知识,通过原子"本能"实现——带有置信度评分的小型学习行为。
v2.1 新增项目范围本能 — React 模式保留在你的 React 项目中,Python 约定保留在你的 Python 项目中,通用模式(如"始终验证输入")则全局共享。
何时激活
- 设置从 Claude Code 会话自动学习
- 通过钩子配置基于本能的行为提取
- 调整学习行为的置信度阈值
- 审查、导出或导入本能库
- 将本能演化为完整的技能、命令或代理
- 管理项目范围与全局本能
- 将本能从项目范围提升到全局范围
v2.1 新特性
| 特性 | v2.0 | v2.1 |
|---------|------|------|
| 存储 | 全局(~/.claude/homunculus/) | 项目范围(${XDG_DATA_HOME:-~/.local/share}/ecc-homunculus/projects/<hash>/) |
| 范围 | 所有本能全局应用 | 项目范围 + 全局 |
| 检测 | 无 | git remote URL / 仓库路径 |
| 提升 | 不适用 | 在 2+ 个项目中出现时从项目提升到全局 |
| 命令 | 4 个(status/evolve/export/import) | 6 个(+promote/projects) |
| 跨项目 | 有污染风险 | 默认隔离 |
v2 新特性(对比 v1)
| 特性 | v1 | v2 | |---------|----|----| | 观察 | Stop 钩子(会话结束) | PreToolUse/PostToolUse(100% 可靠) | | 分析 | 主上下文 | 后台代理(Haiku) | | 粒度 | 完整技能 | 原子"本能" | | 置信度 | 无 | 0.3-0.9 加权 | | 演化 | 直接到技能 | 本能 -> 聚类 -> 技能/命令/代理 | | 共享 | 无 | 导出/导入本能 |
本能模型
本能是一个小型学习行为:
---
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"
---
# Prefer Functional Style
## Action
Use functional patterns over classes when appropriate.
## Evidence
- Observed 5 instances of functional pattern preference
- User corrected class-based approach to functional on 2025-01-15
属性:
- 原子性 -- 一个触发器,一个动作
- 置信度加权 -- 0.3 = 试探性,0.9 = 近乎确定
- 领域标记 -- code-style、testing、git、debugging、workflow 等
- 证据支持 -- 跟踪创建它的观察记录
- 范围感知 --
project(默认)或global
工作原理
Session Activity (in a git repo)
|
| Hooks capture prompts + tool use (100% reliable)
| + detect project context (git remote / repo path)
v
+---------------------------------------------+
| projects/<project-hash>/observations.jsonl |
| (prompts, tool calls, outcomes, project) |
+---------------------------------------------+
|
| Observer agent reads (background, Haiku)
v
+---------------------------------------------+
| PATTERN DETECTION |
| * User corrections -> instinct |
| * Error resolutions -> instinct |
| * Repeated workflows -> instinct |
| * Scope decision: project or global? |
+---------------------------------------------+
|
| Creates/updates
v
+---------------------------------------------+
| projects/<project-hash>/instincts/personal/ |
| * prefer-functional.yaml (0.7) [project] |
| * use-react-hooks.yaml (0.9) [project] |
+---------------------------------------------+
| instincts/personal/ (GLOBAL) |
| * always-validate-input.yaml (0.85) [global]|
| * grep-before-edit.yaml (0.6) [global] |
+---------------------------------------------+
|
| /evolve clusters + /promote
v
+---------------------------------------------+
| projects/<hash>/evolved/ (project-scoped) |
| evolved/ (global) |
| * commands/new-feature.md |
| * skills/testing-workflow.md |
| * agents/refactor-specialist.md |
+---------------------------------------------+
项目检测
系统自动检测你的当前项目:
CLAUDE_PROJECT_DIR环境变量(最高优先级)git remote get-url origin-- 哈希后创建可移植的项目 ID(不同机器上的同一仓库获得相同 ID)git rev-parse --show-toplevel-- 使用仓库路径的回退方案(机器特定)- 全局回退 -- 如果未检测到项目,本能存储在全局范围
