Menu
基于 hooks 自动观察会话行为，创建原子级 instinct（带置信度），可演化为 skill/command/agent。支持项目隔离。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
将现有 Skill 项目改造成同时支持 Claude Code 和 Codex 的插件式安装项目，生成 .claude-plugin、.codex-plugin、marketplace、package.json 与 README 配置；安装命令默认不指定远程分支。
精简版后端开发编排，顺序执行四个核心 skill（plan-write → plan-next → code-simplifier → code-fixer）。当用户说 "/backend-single"、"精简开发" 时触发。需先运行 /plan-init 完成任务分解。适用于现有后端项目的功能开发。
智能开发团队编排，使用 Agent Team 协调六个 skill 的全流程自动化执行。当用户说 "/backend-team" 时触发。从方案预研到代码交付一站式完成。
新项目脚手架团队编排，从零开始搭建项目：需求收集 → 架构设计 → 脚手架搭建 → TDD 开发 → 验证 → CR。当用户说 "/framework-team" 时触发。适用于没有现有代码库的全新项目。
精简版前端开发编排，顺序执行四个核心 skill（plan-write → plan-next → code-simplifier → code-fixer）。当用户说 "/frontend-single"、"前端精简" 时触发。需先运行 /plan-init 完成任务分解。支持 React、Vue3、Vue2 框架自动检测。
前端开发团队编排，串联设计 → 编码 → 打磨 → 审查的完整流水线。当用户说 "/frontend-team" 时触发。支持 React、Vue3、Vue2 三种前端框架，集成 ui-ux-pro-max 设计系统和 frontend-design 美学指南。
| name | instinct |
| description | 基于 hooks 自动观察会话行为，创建原子级 instinct（带置信度），可演化为 skill/command/agent。支持项目隔离。 |
| user-invocable | true |
| version | 1.0.0 |
通过 PreToolUse/PostToolUse hooks 100% 捕获工具调用事件，后台分析模式，创建原子级"直觉"（instinct），可聚类演化为 skill/command/agent。
与 /learn 的区别：/learn 是手动触发的会话回顾，/instinct 是自动观察 + 后台分析，两者互补。
运行 /instinct 加子命令参数。
| 命令 | 功能 |
|---|---|
/instinct status | 显示所有 instincts（项目级 + 全局），按领域分组 |
/instinct export | 导出 instincts 到文件 |
/instinct import <file> | 从文件/URL 导入 instincts |
/instinct evolve | 聚类 instincts，生成 skill/command/agent |
/instinct promote | 升级项目 instinct 到全局 |
/instinct projects | 列出已知项目及 instinct 统计 |
Instinct 是一个小型已学习行为单元：
---
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
在适当时使用函数式模式替代类。
## Evidence
- 在 session abc123 中观察到 5 次
- 用户在 2025-01-15 将类方法纠正为函数式
属性：
project（默认）或 global会话活动（在 git 仓库中）
|
| Hooks 捕获提示 + 工具调用（100% 可靠）
| + 检测项目上下文（git remote / 仓库路径）
v
+---------------------------------------------+
| projects/<项目哈希>/observations.jsonl |
| （提示、工具调用、结果、项目信息） |
+---------------------------------------------+
|
| Observer agent 后台读取（Haiku 模型）
v
+---------------------------------------------+
| 模式检测 |
| * 用户纠正 → instinct |
| * 错误解决 → instinct |
| * 重复工作流 → instinct |
| * 作用域决策：项目级还是全局？ |
+---------------------------------------------+
|
| 创建/更新
v
+---------------------------------------------+
| projects/<哈希>/instincts/personal/ |
| * prefer-functional.yaml (0.7) [project] |
| instincts/personal/ (GLOBAL) |
| * always-validate-input.yaml (0.85) [global]|
+---------------------------------------------+
|
| /instinct evolve 聚类 + /instinct promote
v
+---------------------------------------------+
| evolved/ (项目级或全局) |
| * commands/new-feature.md |
| * skills/testing-workflow.md |
| * agents/refactor-specialist.md |
+---------------------------------------------+
在 ~/.claude/settings.json 中添加：
{
"hooks": {
"PreToolUse": [{
"matcher": "*",
"hooks": [{
"type": "command",
"command": "~/.claude/skills/instinct/hooks/observe.sh pre"
}]
}],
"PostToolUse": [{
"matcher": "*",
"hooks": [{
"type": "command",
"command": "~/.claude/skills/instinct/hooks/observe.sh post"
}]
}]
}
}
注意：也可通过
/setup-permissions扩展来配置。
系统在首次使用时自动创建目录，也可手动初始化：
mkdir -p ~/.claude/homunculus/{instincts/{personal,inherited},evolved/{agents,skills,commands},projects}
/instinct status # 查看所有 instincts
/instinct evolve # 聚类分析，演化为 skill/command/agent
/instinct export # 导出到文件
/instinct import # 从文件/URL 导入
/instinct promote # 项目级 → 全局
/instinct projects # 列出所有项目
当用户调用 /instinct 时，根据参数执行对应的 CLI 命令：
python3 ~/.claude/skills/instinct/scripts/instinct-cli.py status
显示项目级和全局 instincts，按领域分组，包含置信度条形图。
python3 ~/.claude/skills/instinct/scripts/instinct-cli.py export [-o output.yaml] [--scope project|global|all] [--domain <domain>] [--min-confidence <float>]
python3 ~/.claude/skills/instinct/scripts/instinct-cli.py import <file-or-url> [--scope project|global] [--dry-run] [--force] [--min-confidence <float>]
python3 ~/.claude/skills/instinct/scripts/instinct-cli.py evolve [--generate]
分析 instinct 聚类，识别 skill/command/agent 候选。加 --generate 自动生成。
python3 ~/.claude/skills/instinct/scripts/instinct-cli.py promote [instinct_id] [--force] [--dry-run]
python3 ~/.claude/skills/instinct/scripts/instinct-cli.py projects
自动检测当前项目上下文：
CLAUDE_PROJECT_DIR 环境变量（最高优先级）git remote get-url origin — 哈希后生成跨机器唯一 IDgit rev-parse --show-toplevel — 回退方案，机器特定| 分数 | 含义 | 行为 |
|---|---|---|
| 0.3 | 试探性 | 建议但不强制 |
| 0.5 | 中等 | 相关时应用 |
| 0.7 | 强 | 自动应用 |
| 0.9 | 近乎确定 | 核心行为 |
增强：重复观察到、用户未纠正、其他来源一致 衰减：用户明确纠正、长期未观察、出现矛盾证据
| 模式类型 | 作用域 | 示例 |
|---|---|---|
| 语言/框架约定 | 项目 | "使用 React Hooks"、"遵循 Django REST 模式" |
| 文件结构偏好 | 项目 | "测试放 __tests__/"、"组件放 src/components/" |
| 代码风格 | 项目 | "使用函数式风格"、"偏好 dataclasses" |
| 安全实践 | 全局 | "验证用户输入"、"SQL 参数化" |
| 通用最佳实践 | 全局 | "先写测试"、"总是处理错误" |
| 工具工作流偏好 | 全局 | "Edit 前先 Grep"、"Write 前先 Read" |
原则：拿不准时默认项目级 — 项目级提升到全局比反过来安全。
后台 Observer 使用 Haiku 模型分析观察数据，成本效率高。
启动/停止/状态：
~/.claude/skills/instinct/agents/start-observer.sh # 启动
~/.claude/skills/instinct/agents/start-observer.sh stop # 停止
~/.claude/skills/instinct/agents/start-observer.sh status # 检查状态
需要 claude CLI 可用。默认关闭，需在 config.json 中启用。
编辑 ~/.claude/skills/instinct/config.json：
{
"version": "1.0",
"observer": {
"enabled": false,
"run_interval_minutes": 5,
"min_observations_to_analyze": 20
}
}
~/.claude/homunculus/
+-- projects.json # 项目注册表：哈希 → 名称/路径/远程地址
+-- observations.jsonl # 全局观察数据（回退用）
+-- instincts/
| +-- personal/ # 全局自动学习的 instincts
| +-- inherited/ # 全局导入的 instincts
+-- evolved/
| +-- agents/skills/commands/ # 全局演化产物
+-- projects/
+-- <project-hash>/ # 按项目隔离
+-- observations.jsonl
+-- instincts/personal/
+-- instincts/inherited/
+-- evolved/