Menu
基于 hooks 自动观察会话行为，创建原子级 instinct（带置信度），可演化为 skill/command/agent。支持项目隔离。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
将现有 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/