O que agentic-loop faz?
Skill do Codex para executar planos de implementação aprovados por meio de loops limitados de implementar-revisar-reparar-verificar, com inicialização local ao projeto e rastreabilidade.
Visão Geral
Este skill fornece um workflow estruturado para agentes Codex executarem tarefas de implementação complexas, com múltiplos estágios de verificação e capacidade de repetição. Ele garante que as mudanças sejam revisadas e validadas antes de prosseguir, reduzindo o risco de alterações defeituosas.
Como Funciona
- Inicialização: O usuário fornece um plano de implementação (em
plan.md), e o skill cria um ambiente de bootstrap com objetivos, tarefas e arquivos relevantes. - Ciclo Principal: O agente executa repetidamente um ciclo de 4 passos:
- Implementar (Implement): Aplica as mudanças especificadas no plano.
- Revisar (Review): Revisa as mudanças feitas (geralmente usando git diff).
- Reparar (Repair): Corrige quaisquer problemas encontrados.
- Verificar (Verify): Executa verificações finais (ex: testes, linter).
- Resumo: Gera um resumo de mudanças (
changes-it-X.md).
- Limite de Iterações: O loop é interrompido após um número máximo de iterações (padrão: 3).
- Traceabilidade: Cada iteração gera um arquivo de resumo, e o
plan.mdé atualizado para refletir o progresso.
Plataformas Suportadas
- Codex (principal)
Configuração
- Arquivo de Plano:
plan.md(pode ser fornecido pelo usuário ou gerado pelo bootstrap) - Variável de Ambiente:
export CODEX_DEFAULT_SKILLS=echo-ae/agentic-loop(para ativação automática)
Exemplo de Uso
codex "Implementar a funcionalidade de login usando o plano em plan.md"
Estrutura do Projeto
project/
├── plan.md # Plano de implementação ativo
├── changes-it-1.md # Resumo da iteração 1
├── changes-it-2.md # Resumo da iteração 2
└── ...
Notas
- O skill assume que o repositório já está configurado (git, dependências, etc.).
- O bootstrap cria um arquivo
plan.mdse ele não existir, usando o prompt do usuário. - O ciclo é estritamente limitado para evitar loops infinitos.