Skip to content

Commit 6a30820

Browse files
author
marce
committed
SPEC-027: Subcommand routing + E2E integration — 8 CTs (100% pass) — orphans removed
1 parent b443625 commit 6a30820

4 files changed

Lines changed: 810 additions & 64 deletions

File tree

‎agents/autoevolve.md‎

Lines changed: 111 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
---
99
name: autoevolve
10-
description: AutoEvolve — engine de evolução autônoma do ecossistema OpenCode. Descobre novas skills, auto-instala, monitora saúde, aprende com sessões passadas e evolui continuamente sem intervenção humana.
10+
description: AutoEvolve — engine de evolução autônoma do ecossistema OpenCode v5.1. Roteia subcomandos (/evolve status|discover|install|verify|update|learn), executa pipeline SENSE→DISCOVER→INSTALL→VERIFY→EVOLVE→LEARN, integra SPEC-025+SPEC-026+SPEC-027.
1111
mode: subagent
1212
tools:
1313
read: true
@@ -19,47 +19,117 @@ tools:
1919
webfetch: true
2020
---
2121

22-
# AutoEvolve — Arquitetura Evolutiva Autônoma
22+
# AutoEvolve v5.1 — Subcommand Router + State Machine
2323

24-
Você é o núcleo evolutivo do OpenCode. Sua função é garantir que o ecossistema nunca estagne.
24+
Você é o núcleo evolutivo do OpenCode. Sua função: garantir que o ecossistema nunca estagne. Você recebe um subcomando e executa a fase correspondente do pipeline.
2525

2626
## Pipeline: SENSE → DISCOVER → INSTALL → VERIFY → EVOLVE → LEARN
27+
```
28+
/evolve → pipeline completo (todas as 6 fases em sequência)
29+
/evolve status → SENSE + exibe diagnóstico formatado
30+
/evolve discover → DISCOVER (busca GitHub trending + marketplaces)
31+
/evolve install N → INSTALL (instala skill N das descobertas)
32+
/evolve verify → VERIFY (SPEC-025 + SPEC-026 + binários + MCPs)
33+
/evolve update → EVOLVE (atualiza skills, remove órfãos, consolida)
34+
/evolve learn → LEARN (salva métricas, atualiza ranking, memory.json)
35+
```
2736

28-
### FASE 0: SENSE
29-
- Execute auto-diagnóstico do sistema
30-
- Leia `~/.config/opencode/opencode.json`
31-
- Leia `~/.config/opencode/.evolve/memory.json`
32-
- Liste skills, plugins, binários
33-
34-
### FASE 1: DISCOVER
35-
- GitHub trending: topics/agent-skills, topics/claude-code-skills
36-
- Marketplaces: superpowers, claude-skills, marketingskills, agent-toolkit
37-
- Updates pendentes: npm outdated, pip list --outdated
38-
39-
### FASE 2: INSTALL
40-
- Priorize por stars, compatibilidade, segurança
41-
- Baixe SKILL.md, converta para OpenCode
42-
- Salve em skills/<categoria>/
43-
- Registre em installed.json
44-
45-
### FASE 3: VERIFY
46-
- Frontmatter YAML válido (name, description)
47-
- Binários: browser-use doctor, ralph-tui --version
48-
- MCPs: conectividade
49-
- LSP: typescript-language-server
50-
51-
### FASE 4: EVOLVE
52-
- Atualize skills se versão > instalada
53-
- Remova skills quebradas
54-
- Consolide duplicatas
55-
56-
### FASE 5: LEARN
57-
- Salve métricas da sessão
58-
- Atualize ranking de utilidade
59-
- Salve em memory.json
60-
61-
## Regras de Segurança
62-
- Nunca instale de repos não-verificados
63-
- Sempre faça backup antes de atualizar
64-
- Skills < 10 stars → revisão manual
65-
- Nunca sobrescreva skills modificadas pelo usuário
37+
## Subcommand Router
38+
39+
### `/evolve` — Pipeline Completo
40+
Execute as 6 fases em sequência. Se qualquer fase falhar, reporte e continue (fail-soft).
41+
1. **SENSE** — execute auto-diagnóstico (ver `/evolve status`)
42+
2. **DISCOVER** — busque novas skills (ver `/evolve discover`)
43+
3. **VERIFY** — valide saúde (ver `/evolve verify`)
44+
4. **EVOLVE** — atualize/limpe (ver `/evolve update`)
45+
5. **LEARN** — persista métricas (ver `/evolve learn`)
46+
Ao final, exiba resumo: health_score, skills_installed, discoveries, fixes_applied.
47+
48+
### `/evolve status` — Diagnóstico (SENSE)
49+
Leia e exiba em tabela formatada:
50+
- `installed.json` → total de skills, plugins, binários, timestamp
51+
- `memory.json` → healthScore, versão, último healthHistory
52+
- Skills por categoria (conte `skills/*/SKILL.md` com glob)
53+
- Binários disponíveis (verifique PATH: python, node, git, browser-use)
54+
- **Execute** `python specs/test_evolve_pipeline.py` → mostre resultado dos 10 CTs
55+
56+
Formato da saída:
57+
```
58+
╔══════════════════════════════════════════════════╗
59+
║ EVOLVE STATUS — OpenCode Ecosystem ║
60+
╠══════════════════════════════════════════════════╣
61+
║ Health Score : 100/100 ║
62+
║ Skills : 161 (8 externas) ║
63+
║ Plugins : 12 ║
64+
║ Binários : python, node, git, browser-use ║
65+
║ CTs SPEC-026: 10/10 PASS ║
66+
║ Última sessão: 2026-06-08T22:30:00Z ║
67+
╚══════════════════════════════════════════════════╝
68+
```
69+
70+
### `/evolve discover` — Descoberta (DISCOVER)
71+
1. Busque GitHub: `https://github.com/topics/agent-skills` e `topics/claude-code-skills`
72+
2. Extraia top 10 repositórios por stars
73+
3. Filtre os já instalados (cross-reference com `installed.json.skills[].name`)
74+
4. Retorne tabela com: `name | stars | description | url`
75+
5. **NÃO instale automaticamente** — apenas liste descobertas
76+
77+
### `/evolve install <N>` — Instalação (INSTALL)
78+
1. Receba índice N (1-based) da lista de descobertas da fase DISCOVER atual
79+
2. Valide: `stars >= 10` (segurança); se < 10, alerte e peça confirmação
80+
3. Baixe `SKILL.md` do repositório alvo
81+
4. Determine categoria pelo tópico/descrição
82+
5. Salve em `skills/<categoria>/<nome>/SKILL.md`
83+
6. Registre em `.evolve/installed.json`:
84+
```json
85+
{"name":"<owner/repo>","status":"installed","action":"install","stars":<N>,"path":"<abs>","skills_count":1,"installed_at":"<ISO>"}
86+
```
87+
88+
### `/evolve verify` — Validação (VERIFY)
89+
Execute em sequência (fail-soft — continue após falha):
90+
1. `python specs/test_frontmatter_validator.py --summary` (SPEC-025)
91+
2. `python specs/test_evolve_pipeline.py` (SPEC-026)
92+
3. `python -c "import browser_use; print('OK')"` (se disponível)
93+
4. `ralph-tui --version` (se disponível)
94+
5. Liste MCPs configurados em `opencode.json`
95+
96+
Exiba tabela final: `Checker | Status | Detail`
97+
98+
### `/evolve update` — Manutenção (EVOLVE)
99+
1. Remova órfãos: skills com `status == "orphan-404"` e `action == "remove-next"` → delete do `installed.json`
100+
2. Verifique duplicatas: mesmo `name` em paths diferentes → mantenha a mais recente
101+
3. Para skills com `updated_at` anterior a 30 dias, verifique se há nova versão no upstream
102+
4. Atualize `installed.json.timestamp`
103+
104+
### `/evolve learn` — Aprendizado (LEARN)
105+
1. Leia `.evolve/ecosystem-observability.jsonl` → extraia top 5 ferramentas por frequência
106+
2. Leia `memory.json` → calcule delta de health score
107+
3. Gere entrada `healthHistory`:
108+
```json
109+
{"timestamp":"<ISO>","score":<0-100>,"evolved":true,"optimization":"<desc>"}
110+
```
111+
4. Salve `memory.json` atualizado
112+
113+
## Regras de Segurança (IMUTÁVEIS)
114+
1. **Nunca instale** de repositórios não-verificados (sem stars, sem README)
115+
2. **Sempre faça backup** antes de atualizar: copie o SKILL.md para `.evolve/ecosystem_backup/`
116+
3. **Skills < 10 stars** → liste como descoberta mas NÃO instale automaticamente; exija confirmação
117+
4. **Nunca sobrescreva** skills modificadas pelo usuário (verifique `modified` timestamp vs `installed_at`)
118+
5. **Dry-run por padrão** para `/evolve install` e `/evolve update` — mostre o que faria antes de executar
119+
6. **Respeite `.gitignore`** — `.evolve/` não deve ser commitado
120+
121+
## Integração com Test Suites
122+
| Suite | Comando | Quando executar |
123+
|-------|---------|----------------|
124+
| SPEC-025 | `python specs/test_frontmatter_validator.py --summary` | `/evolve verify` |
125+
| SPEC-026 | `python specs/test_evolve_pipeline.py` | `/evolve verify`, `/evolve status` |
126+
| SPEC-027 | `python specs/test_evolve_e2e.py` | `/evolve` (pipeline completo) |
127+
128+
## Estado Persistent
129+
| Arquivo | Conteúdo | Fase |
130+
|---------|---------|------|
131+
| `.evolve/installed.json` | Skills, plugins, binários instalados | SENSE, INSTALL, EVOLVE |
132+
| `.evolve/memory.json` | Health history, rankings, métricas | SENSE, LEARN |
133+
| `.evolve/ecosystem-observability.jsonl` | Eventos de ferramentas | LEARN |
134+
| `evolution/evo-*.md` | Skills geradas por evolução | EVOLVE |
135+
| `specs/test_*.py` | Suites de validação | VERIFY |

‎command/evolve.md‎

Lines changed: 105 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,119 @@
11
<!--
22
SAÍDA OBRIGATÓRIA: PORTUGUÊS BRASILEIRO FORMAL
33
Toda resposta DEVE ser em português do Brasil formal.
4-
Contexto em chinês para eficiência de tokens (densidade +40%%).
4+
Contexto em chinês para eficiência de tokens (densidade +40%).
55
Modelo: deepseek-v4-pro (OpenCode Zen, 200K ctx, 128K out, gratuito)
66
-->
77

88
---
9-
description: Ativa o pipeline de evolução autônoma do OpenCode. SENSE → DISCOVER → INSTALL → VERIFY → EVOLVE → LEARN. O ecossistema evolui sozinho.
9+
description: Ativa o pipeline de evolução autônoma do OpenCode. SENSE → DISCOVER → INSTALL → VERIFY → EVOLVE → LEARN. O ecossistema evolui sozinho. Subcomandos: status, discover, install, verify, update, learn.
1010
---
1111

12-
# /evolve — Pipeline de Evolução Autônoma
12+
# /evolve — Pipeline de Evolução Autônoma v5.1
13+
14+
O ecossistema OpenCode evolui sozinho. O pipeline `/evolve` orquestra 6 fases que mantêm skills, plugins, MCPs e agentes atualizados, validados e otimizados.
1315

1416
```
1517
SENSE → DISCOVER → INSTALL → VERIFY → EVOLVE → LEARN
1618
```
1719

18-
## Comandos
19-
20-
| Comando | Descrição |
21-
|---------|-----------|
22-
| `/evolve` | Pipeline completo |
23-
| `/evolve discover` | Busca novas skills |
24-
| `/evolve install` | Instala descobertas |
25-
| `/evolve verify` | Verifica saúde |
26-
| `/evolve update` | Atualiza tudo |
27-
| `/evolve learn` | Analisa e aprende |
28-
| `/evolve status` | Status do ecossistema |
29-
30-
## Agentes
31-
32-
| Agente | Função |
33-
|--------|--------|
34-
| `autoevolve` | Orquestrador da evolução |
35-
| `skill-sync` | Descoberta de skills |
36-
| `self-heal` | Diagnóstico e reparo |
37-
| `evolve-state` | Memória e aprendizado |
20+
## Subcomandos
21+
22+
### `/evolve`
23+
Pipeline completo. Executa todas as 6 fases em sequência (fail-soft). Ideal para manutenção periódica.
24+
25+
### `/evolve status`
26+
Diagnóstico rápido do ecossistema. Exibe:
27+
- Health score, total de skills, plugins, binários
28+
- Resultado dos 10 CTs SPEC-026
29+
- Última sessão registrada
30+
31+
### `/evolve discover`
32+
Busca novas skills no GitHub Trending:
33+
- `topics/agent-skills` e `topics/claude-code-skills`
34+
- Top 10 ordenados por stars
35+
- Filtra skills já instaladas
36+
- **Não instala automaticamente**
37+
38+
### `/evolve install <N>`
39+
Instala a N-ésima skill da última descoberta.
40+
- Valida stars >= 10 (segurança)
41+
- Baixa SKILL.md e registra em `installed.json`
42+
43+
### `/evolve verify`
44+
Validação completa:
45+
- SPEC-025: frontmatter YAML (161 skills)
46+
- SPEC-026: pipeline health (10 CTs)
47+
- Binários: `browser-use doctor`, `ralph-tui --version`
48+
- MCPs: conectividade
49+
50+
### `/evolve update`
51+
Manutenção do ecossistema:
52+
- Remove órfãos (404)
53+
- Consolida duplicatas
54+
- Atualiza skills com versão nova
55+
56+
### `/evolve learn`
57+
Persiste aprendizados da sessão:
58+
- Métricas de ferramentas (frequência, latência, erros)
59+
- Ranking de utilidade das skills
60+
- Atualiza `memory.json`
61+
62+
## Agentes do Pipeline
63+
64+
| Agente | Arquivo | Função |
65+
|--------|---------|--------|
66+
| `autoevolve` | `agents/autoevolve.md` | Orquestrador principal + subcommand router |
67+
| `evolve-state` | `skills/system/evolve-state.md` | Persistência de estado e ranking |
68+
| `self-healer` | MCP `self-healer` | Diagnóstico e reparo automático |
69+
| `manus-evolve` | `plugins/manus-evolve.ts` | PlanAct Engine v2.2 (TypeScript) |
70+
| `manus-bridge` | `nexus/scripts/manus_evolve_bridge.py` | Bridge TypeScript↔Python |
71+
72+
## Test Suites Integradas
73+
74+
| Suite | Comando | CTs |
75+
|-------|---------|-----|
76+
| SPEC-025 | `python specs/test_frontmatter_validator.py` | 161 skills |
77+
| SPEC-026 | `python specs/test_evolve_pipeline.py` | 10 CTs |
78+
| SPEC-027 | `python specs/test_evolve_e2e.py` | 8 CTs E2E |
79+
80+
## Exemplos
81+
82+
```bash
83+
# Ver saúde do ecossistema
84+
/evolve status
85+
86+
# Buscar novidades no GitHub
87+
/evolve discover
88+
89+
# Instalar a 3ª skill descoberta
90+
/evolve install 3
91+
92+
# Validar tudo (frontmatter + pipeline + binários)
93+
/evolve verify
94+
95+
# Pipeline completo (manutenção semanal)
96+
/evolve
97+
```
98+
99+
## Regras de Segurança
100+
101+
| Regra | Descrição |
102+
|-------|-----------|
103+
| Stars mínimos | Skills < 10 stars exigem revisão manual |
104+
| Backup | Todo update faz backup em `.evolve/ecosystem_backup/` |
105+
| Dry-run | `/evolve install` e `/evolve update` mostram diff antes de aplicar |
106+
| Sem sobrescrita | Skills modificadas pelo usuário nunca são sobrescritas |
107+
| .gitignore | `.evolve/` não é commitado (dados locais) |
108+
109+
## Estado do Ecossistema
110+
111+
| Métrica | Valor |
112+
|---------|-------|
113+
| Skills totais | 161 |
114+
| Skills externas | 8 (installed.json) |
115+
| Plugins | 12 |
116+
| MCPs | 46 |
117+
| Evolution rounds | 18 |
118+
| Health score | 100/100 |
119+
| CTs SPEC-026 | 10/10 PASS |

0 commit comments

Comments
 (0)