Habilidade AI-Loop

Visão Geral

A habilidade ai-loop estrutura um ciclo de desenvolvimento limitado para fluxos de trabalho de agentes. Ao dividir o processo em fases distintas de planejamento (Spec), implementação (Build) e validação (Review), ela ajuda um agente a construir e corrigir alterações de código com escopo, mantendo os requisitos, portões de risco e condições de parada explícitos.

Quando Usar Esta Habilidade

• Use quando precisar de um recurso construído do zero ou significativamente modificado, e quiser que o agente gerencie o ciclo de vida (especificação, implementação e verificação) dentro de um fluxo de trabalho claramente delimitado.
• Use ao trabalhar com componentes, módulos ou recursos isolados que tenham escopos e restrições bem definidos.
• Use quando o usuário solicitar uma passagem completa de desenvolvimento, mas o trabalho ainda tiver critérios de sucesso claros, um caminho de verificação razoável e nenhuma decisão de segurança ou produto pendente.

Como Funciona

Esta habilidade executa um loop de desenvolvimento controlado composto por três fases: Spec, Build e Review. Quando invocada, o agente transita por essas fases até que os requisitos com escopo passem na verificação, uma condição de parada seja atingida ou a aprovação humana seja necessária.

Antes de começar, defina:

• O número máximo de iterações de build-review.
• Os comandos de verificação ou verificações manuais que contam como evidência.
• As ações que exigem aprovação explícita, como comandos destrutivos, alterações de produção, gravações em serviços externos ou pivôs arquitetônicos amplos.

Fase 1: Spec (Planejamento)

1. Reutilize a solicitação atual, o plano aceito e os artefatos existentes. Peça apenas o escopo essencial em falta ou critérios de aceitação; não repita perguntas já respondidas.
2. Não comece a construir ainda.
3. Quando tiver informações suficientes, use a especificação existente ou, quando necessário, salve uma nova com escopo em specs/<feature-name>.md sem sobrescrever o trabalho do usuário.
4. A especificação deve incluir:
   • O objetivo
   • Os requisitos exatos
   • Casos de borda a serem tratados
   • Uma definição concreta de "pronto" que alguém possa usar para verificar a construção
   • O orçamento de iteração, comandos de verificação e portões de aprovação.

Fase 2: Build (Implementação)

1. Leia a especificação que você acabou de criar em specs/<feature-name>.md.
2. Construa exatamente o que ela descreve.
3. Não adicione recursos, não refatore código não relacionado e não invente requisitos que não estejam na especificação.
4. Concentre-se estritamente em cumprir a especificação. Liste quais requisitos da especificação você cobriu para que a etapa de revisão possa verificá-los.

Fase 3: Review (Verificação)

1. Compare sua implementação com specs/<feature-name>.md.
2. Vá requisito por requisito e verifique se ele foi atendido. Liste cada lacuna, bug ou peça que falta, nomeando o item exato da especificação que cada um falha.
3. Se algo falhar e o orçamento de iteração não estiver esgotado, escreva as correções específicas necessárias e retorne à Fase 2 (Build) para abordá-las.
4. Use os limites de iteração/recursos acordados e o escopo. Peça decisões de autorização de produto material ou consequenciais que ainda não foram resolvidas; reparos rotineiros dentro do resultado aceito não precisam de um novo checkpoint. Continue o trabalho independente quando uma verificação dependente não estiver disponível.
5. Passe a construção e conclua a execução da habilidade apenas quando todos os requisitos na especificação forem totalmente atendidos e as evidências de verificação declaradas tiverem passado.

Exemplos

Exemplo 1: Criando um Auxiliar Básico de Estatísticas

Usuário:

Quero adicionar uma utilidade para calcular estatísticas básicas (média, mediana, moda) de um array de números.

Agente (Fase 1 - Spec):

Posso ajudar com isso. Para começar, em qual linguagem de programação este calculador de estatísticas deve ser implementado? Além disso, como arrays vazios ou entradas inválidas devem ser tratados?

Usuário:

JavaScript. Se o array estiver vazio, retorne null. Se houver não números, ignore-os.

Agente (Fase 1 - Spec):

Obrigado. Criei o arquivo de especificação em specs/stats-calculator.md com os requisitos que discutimos. Agora, começarei a implementá-lo.

Agente (Fase 2 - Build):

(Cria stats_calculator.js e implementa mean, median e mode correspondendo exatamente à especificação) Terminei de implementar o calculador. Agora verificarei a implementação.

Agente (Fase 3 - Review):

Verificando a implementação contra specs/stats-calculator.md:

• Requisito: cálculo da média -> PASS
• Requisito: cálculo da mediana -> PASS
• Requisito: cálculo da moda -> PASS
• Requisito: array vazio retorna null -> PASS

…