evolve — команда для Claude Code: что делает и как установить
Команда evolve для Claude Code группирует связанные инстинкты в команды, скиллы и субагентов. Собирает накопленные правила в рабочие структуры.
MIT ★ 880 обновлён 2026-09-03
.claude/commands/evolve.mdЧто делает evolve
evolve читает инстинкты из ~/.claude/homunculus/instincts/, объединяет их по домену, похожим триггерам и последовательности действий. Для каждой группы команда выбирает тип: пользовательскую слэш-команду, автоматически запускаемый скилл или субагента для сложного процесса.
По умолчанию команда показывает предварительный результат. Флаг --execute создаёт файлы в ~/.claude/homunculus/evolved/{commands,skills,agents}/ и связывает новые структуры с исходными инстинктами. Есть фильтры по домену и типу, а также порог числа связанных инстинктов. Реализация запускает python3, поэтому без Python 3 команда не выполнит анализ.
Какие задачи решает
- сгруппировать связанные инстинкты по смыслу
- собрать повторяющиеся действия в слэш-команду
- превратить правила поведения в скилл
- выделить многошаговый процесс в субагента
- просмотреть будущие файлы до их создания
Примеры запросов агенту
- Проанализируй все инстинкты командой
/evolve. - Покажи эволюцию только для домена
testingчерез/evolve --domain testing. - Предварительно проверь создание структур с
/evolve --dry-run.
Как установить evolve
Вручную: положить файлы
.claude/commands/evolve.mdВызов — /evolve. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/evolve.mdВызов — /prompts:evolve. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/evolve.prompt.mdВручную: положить файлы
.gemini/commands/evolve.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы об evolve
Как установить evolve в Claude Code?
Сохраните файл команды по пути .claude/commands/evolve.md. После этого в Claude Code доступен вызов /evolve.
Что делает evolve?
Команда анализирует инстинкты и объединяет связанные записи в команды, скиллы или субагенты. Результат можно сначала просмотреть, а затем создать через --execute.
Можно ли ограничить анализ evolve?
Да. Используйте --domain <name> для одного домена, --type <command|skill|agent> для одного типа или --threshold <n> для минимального размера группы.
Исходный текст
evolve.md · MIT
---
name: evolve
description: Cluster related instincts into skills, commands, or agents
command: /evolve
implementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve
---
# Evolve Command
## Implementation
```bash
python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py evolve [--generate]
```
Analyzes instincts and clusters related ones into higher-level structures:
- **Commands**: When instincts describe user-invoked actions
- **Skills**: When instincts describe auto-triggered behaviors
- **Agents**: When instincts describe complex, multi-step processes
## Usage
```
/evolve # Analyze all instincts and suggest evolutions
/evolve --domain testing # Only evolve instincts in testing domain
/evolve --dry-run # Show what would be created without creating
/evolve --threshold 5 # Require 5+ related instincts to cluster
```
## Evolution Rules
### → Command (User-Invoked)
When instincts describe actions a user would explicitly request:
- Multiple instincts about "when user asks to..."
- Instincts with triggers like "when creating a new X"
- Instincts that follow a repeatable sequence
Example:
- `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"
→ Creates: `/new-table` command
### → Skill (Auto-Triggered)
When instincts describe behaviors that should happen automatically:
- Pattern-matching triggers
- Error handling responses
- Code style enforcement
Example:
- `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"
→ Creates: `functional-patterns` skill
### → Agent (Needs Depth/Isolation)
When instincts describe complex, multi-step processes that benefit from isolation:
- Debugging workflows
- Refactoring sequences
- Research tasks
Example:
- `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"
→ Creates: `debugger` agent
## What to Do
1. Read all instincts from `~/.claude/homunculus/instincts/`
2. Group instincts by:
- Domain similarity
- Trigger pattern overlap
- Action sequence relationship
3. For each cluster of 3+ related instincts:
- Determine evolution type (command/skill/agent)
- Generate the appropriate file
- Save to `~/.claude/homunculus/evolved/{commands,skills,agents}/`
4. Link evolved structure back to source instincts
## Output Format
```
🧬 Evolve Analysis
==================
Found 3 clusters ready for evolution:
## Cluster 1: Database Migration Workflow
Instincts: new-table-migration, update-schema, regenerate-types
Type: Command
Confidence: 85% (based on 12 observations)
Would create: /new-table command
Files:
- ~/.claude/homunculus/evolved/commands/new-table.md
## Cluster 2: Functional Code Style
Instincts: prefer-functional, use-immutable, avoid-classes, pure-functions
Type: Skill
Confidence: 78% (based on 8 observations)
Would create: functional-patterns skill
Files:
- ~/.claude/homunculus/evolved/skills/functional-patterns.md
## Cluster 3: Debugging Process
Instincts: debug-check-logs, debug-isolate, debug-reproduce, debug-verify
Type: Agent
Confidence: 72% (based on 6 observations)
Would create: debugger agent
Files:
- ~/.claude/homunculus/evolved/agents/debugger.md
---
Run `/evolve --execute` to create these files.
```
## Flags
- `--execute`: Actually create the evolved structures (default is preview)
- `--dry-run`: Preview without creating
- `--domain <name>`: Only evolve instincts in specified domain
- `--threshold <n>`: Minimum instincts required to form cluster (default: 3)
- `--type <command|skill|agent>`: Only create specified type
## Generated File Format
### Command
```markdown
---
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 Command
[Generated content based on clustered instincts]
## Steps
1. ...
2. ...
```
### Skill
```markdown
---
name: functional-patterns
description: Enforce functional programming patterns
evolved_from:
- prefer-functional
- use-immutable
- avoid-classes
---
# Functional Patterns Skill
[Generated content based on clustered instincts]
```
### Agent
```markdown
---
name: debugger
description: Systematic debugging agent
model: sonnet
evolved_from:
- debug-check-logs
- debug-isolate
- debug-reproduce
---
# Debugger Agent
[Generated content based on clustered instincts]
```
© sangrokjung · MIT · sangrokjung/claude-forge