用途：把 Claude Code 会话转化为可复用知识。它通过钩子（PreToolUse/PostToolUse）以 100% 可靠性捕获提示与工具调用，由后台观察代理（Haiku）分析，提取用户纠正、错误解决、重复工作流等模式，生成原子“本能”——一条触发对应一个动作，带 0.3–0.9 置信度、领域标签与证据记录。
主要能力：v2.1 支持项目作用域（projects/<hash>/）与全局作用域，通过 CLAUDE_PROJECT_DIR、git remote URL（哈希为可移植项目 ID）或仓库路径自动检测项目；同一本能出现在 2+ 项目且平均置信度≥0.8 时可提升为全局。提供命令：/instinct-status、/evolve、/instinct-export、/instinct-import、/promote、/projects。
使用方式：在 ~/.claude/settings.json 配置钩子指向 hooks/observe.sh；可选手动创建 ~/.claude/homunculus 目录；用 python3 instinct-cli.py promote（支持 --dry-run）提升本能。配置由 config.json 控制后台观察代理（默认 enabled=false、间隔 5 分钟、最少 20 条观察）。
限制与隐私：观察数据保存在本地，项目本能默认隔离，仅本能（模式）可导出，原始代码与对话不外传。v2.1 向下兼容 v2.0 与 v1。