用途：通过原子级“本能”（带置信度评分的小型学习行为）把 Claude Code 会话转化为可复用知识。设置从会话中自动学习、配置钩子提取行为、调整置信度阈值、查看/导出/导入本能库、将本能演化为技能/命令/智能体、管理项目作用域与全局本能、将项目本能提升到全局。
主要能力：v2.1 存储于项目作用域（projects/<hash>/），作用域为项目+全局，支持 git remote URL/仓库路径检测，当同一本能在 2 个以上项目出现时由项目提升到全局；命令由 4 个增至 6 个（+promote/projects）。相比 v1，观察改用 PreToolUse/PostToolUse（100% 可靠）而非 Stop 钩子，分析由后台智能体（Haiku）完成，粒度从完整技能变为原子本能，引入 0.3-0.9 置信度加权，演化路径为“本能→聚类→技能/命令/智能体”，并支持导出/导入。
使用方式：在 ~/.claude/settings.json 配置 PreToolUse 与 PostToolUse 钩子指向 hooks/observe.sh（插件安装用 ${CLAUDE_PLUGIN_ROOT}，手动安装用 ~/.claude/skills 路径）；可用 mkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands},projects} 初始化目录；常用命令包括 /instinct-status、/evolve、/instinct-export、/instinct-import、/promote、/projects；配置文件控制后台观察者的 enabled、run_interval_minutes、min_observations_to_analyze。提升示例：python3 instinct-cli.py promote prefer-explicit-errors（可用 --dry-run 预览）。
适用场景与限制：适合需要跨会话沉淀代码风格、框架约定、工作流与通用实践的开发场景；项目检测优先 CLAUDE_PROJECT_DIR，其次 git remote get-url origin（可移植哈希 ID），再退到 git rev-parse --show-toplevel，未检测到项目则落入全局。观察数据保存在本地，仅本能（模式）可导出，不分享代码或对话；v2.1 兼容 v2.0 与 v1，可并行运行。其他行为（观察捕获、阈值、作用域划分、提升标准）通过代码默认值配置，官方未提供图形界面说明。具体收费、价格与确切安装步骤暂未提供。