everything-claude-code-zh/commands/evolve.md

name, description, command

name	description	command
evolve	将相关的直觉（Instincts）聚类为技能（Skills）、命令（Commands）或智能体（Agents）	true

Evolve 命令

实现 (Implementation)

使用插件根路径运行直觉（Instinct）命令行界面（CLI）：

python3 "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/scripts/instinct-cli.py" evolve [--generate]

或者如果未设置 CLAUDE_PLUGIN_ROOT（手动安装）：

python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]

分析直觉（Instincts）并将相关的直觉聚类为更高级的结构：

• 命令（Commands）：当直觉描述用户调用的操作时
• 技能（Skills）：当直觉描述自动触发的行为时
• 智能体（Agents）：当直觉描述复杂的、多步骤的流程时

用法 (Usage)

/evolve                    # 分析所有直觉并建议演进方案
/evolve --domain testing   # 仅演进测试领域（testing domain）中的直觉
/evolve --dry-run          # 显示将要创建的内容而不实际创建
/evolve --threshold 5      # 要求至少有 5 个以上的相关直觉才进行聚类

演进规则 (Evolution Rules)

→ 命令 (Command)（用户调用）

当直觉描述用户会明确请求的操作时：

• 多个关于“当用户要求...”的直觉
• 带有“当创建新的 X 时”等触发器的直觉
• 遵循可重复序列的直觉

示例：

• new-table-step1: "when adding a database table, create migration"
• new-table-step2: "when adding a database table, update schema"
• new-table-step3: "when adding a database table, regenerate types"

→ 创建：/new-table 命令

→ 技能 (Skill)（自动触发）

当直觉描述应该自动发生的行为时：

• 模式匹配触发器
• 错误处理响应
• 代码风格强制执行

示例：

• prefer-functional: "when writing functions, prefer functional style"
• use-immutable: "when modifying state, use immutable patterns"
• avoid-classes: "when designing modules, avoid class-based design"

→ 创建：functional-patterns 技能（Skill）

→ 智能体 (Agent)（需要深度/隔离）

当直觉描述复杂的、多步骤的流程，且受益于隔离环境时：

• 调试工作流（Workflow）
• 重构序列
• 研究任务

示例：

• debug-step1: "when debugging, first check logs"
• debug-step2: "when debugging, isolate the failing component"
• debug-step3: "when debugging, create minimal reproduction"
• debug-step4: "when debugging, verify fix with test"

→ 创建：debugger 智能体（Agent）

操作步骤 (What to Do)

1. 从 ~/.claude/homunculus/instincts/ 读取所有直觉（Instincts）
2. 按以下维度对直觉进行分组：
   • 领域（Domain）相似性
   • 触发模式重合度
   • 操作序列关联性
3. 对于每个包含 3 个及以上相关直觉的聚类：
   • 确定演进类型（命令/技能/智能体）
   • 生成相应的文件
   • 保存至 ~/.claude/homunculus/evolved/{commands,skills,agents}/
4. 将演进后的结构链接回原始直觉

输出格式 (Output Format)

🧬 演进分析 (Evolve Analysis)
==================

发现 3 个已准备好演进的聚类：

## 聚类 1：数据库迁移工作流 (Database Migration Workflow)
直觉 (Instincts): new-table-migration, update-schema, regenerate-types
类型: 命令 (Command)
置信度: 85% (基于 12 次观察)

将创建: /new-table 命令
文件:
  - ~/.claude/homunculus/evolved/commands/new-table.md

## 聚类 2：函数式代码风格 (Functional Code Style)
直觉 (Instincts): prefer-functional, use-immutable, avoid-classes, pure-functions
类型: 技能 (Skill)
置信度: 78% (基于 8 次观察)

将创建: functional-patterns 技能 (Skill)
文件:
  - ~/.claude/homunculus/evolved/skills/functional-patterns.md

## 聚类 3：调试流程 (Debugging Process)
直觉 (Instincts): debug-check-logs, debug-isolate, debug-reproduce, debug-verify
类型: 智能体 (Agent)
置信度: 72% (基于 6 次观察)

将创建: debugger 智能体 (Agent)
文件:
  - ~/.claude/homunculus/evolved/agents/debugger.md

---
运行 `/evolve --execute` 来创建这些文件。

参数标志 (Flags)

• --execute: 实际创建演进后的结构（默认为预览）
• --dry-run: 预览而不创建
• --domain <name>: 仅演进指定领域（Domain）中的直觉
• --threshold <n>: 形成聚类所需的最小直觉数量（默认值：3）
• --type <command|skill|agent>: 仅创建指定类型

生成的文件格式 (Generated File Format)

命令 (Command)

---
name: new-table
description: Create a new database table with migration, schema update, and type generation
command: /new-table
evolved_from:
  - new-table-migration
  - update-schema
  - regenerate-types
---

# New Table 命令

[基于聚类直觉生成的正文内容]

## 步骤
1. ...
2. ...

技能 (Skill)

---
name: functional-patterns
description: Enforce functional programming patterns
evolved_from:
  - prefer-functional
  - use-immutable
  - avoid-classes
---

# Functional Patterns 技能 (Skill)

[基于聚类直觉生成的正文内容]

智能体 (Agent)

---
name: debugger
description: Systematic debugging agent
model: sonnet
evolved_from:
  - debug-check-logs
  - debug-isolate
  - debug-reproduce
---

# Debugger 智能体 (Agent)

[基于聚类直觉生成的正文内容]