CommunityEscrita e Ediçãogithub.com

ouob-tw/LoopAgentTeams

Trabalho em equipe multi-agente orientado por especificações para qualquer agente com suporte a skills (Claude Code, Codex e mais) — planejar, despachar, monitorar, QA. Sem dependência de framework.

O que é LoopAgentTeams?

LoopAgentTeams é um skill de Agente de IA para sistemas como Claude Code, Codex e outros agentes com suporte a skills, que implementa um workflow de execução de tarefas orientado por especificações. Ele permite que uma equipe de agentes colabore seguindo planos definidos em arquivos `.lat/tasks.yaml`, sem exigir um framework externo. O skill lê as tarefas aprovadas, executa-as sequencialmente conforme os planos armazenados, e registra resultados no arquivo `results.yaml`. Ele não cria processos em segundo plano nem mantém sessões abertas, encerrando normalmente após processar a fila atual. É útil para equipes que precisam de um sistema leve e flexível para coordenação de tarefas de implementação, com suporte a estados como 'completed', 'partial' e 'failed'.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add ouob-tw/LoopAgentTeams

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

LAT Runner

Executa tarefas de implementação aprovadas de .lat/tasks.yaml, normalmente iniciado por lat-dispatch.

Limites de Execução

  • Apenas executa tarefas de implementação aprovadas. Não lida com revisão de especificações ou revisão de planos.
  • Após processar a fila atual, encerra normalmente. Não cria processos em segundo plano ou ouvintes de longo prazo.

Fluxo de Processamento

  1. Lê .lat/tasks.yaml.
  2. Arquivo ausente, vazio ou [] → Gera No pending tasks, sai com código 0.
  3. Falha na análise YAML → Segue o fluxo de tratamento de erros de análise conforme references/yaml-schema.md.
  4. Processa tarefas de cima para baixo, cada tarefa seguindo a checklist abaixo:
- [ ] Ler o goal, context e constraints da tarefa
- [ ] Se houver plan_file → ler o arquivo de plano, confirmar ordem das etapas
- [ ] Determinar se corresponde a habilidades de domínio disponíveis; carregar se corresponder
- [ ] Executar a implementação na ordem das etapas do plano (ou conforme o goal)
- [ ] Inserir resultado no topo de results.yaml (usando o mesmo task_id e agent_id)
- [ ] Remover esta tarefa de tasks.yaml

Regras complementares:

  • Quando existe context.plan_file, deve-se ler o plano primeiro e executar na ordem definida das etapas. Após cada etapa, o projeto deve ser executável.
  • Tarefas simples sem arquivo de plano: executar diretamente conforme o goal.
  • O skill não pode ampliar o escopo da tarefa; em caso de conflito com constraints, prevalecem as constraints.
  • Remover tarefas processadas de tasks.yaml (independentemente de concluídas, parciais ou falhas). Manter tarefas não processadas.

Estados de Resultado

EstadoSignificado
completedObjetivo da tarefa totalmente alcançado
partialAlcançado parcialmente; summary deve descrever o que foi e o que não foi concluído
failedNão concluído; errors deve conter pelo menos um objeto {code, message}

Tarefas Subsequentes

  • Apenas adicionar se a tarefa grande precisar ser dividida e o trabalho restante puder ser rastreado.
  • Usar o mesmo task_id (nome do arquivo Spec), incrementar o round de agent_id (ex.: code_executor_2_<task_id>, code_executor_3_<task_id>), e preencher created_by com o identificador do agente atual.
  • Apenas tarefas de implementação; não adicionar tarefas de revisão.

Saída ao Finalizar

  • Sem tarefas → No pending tasks, código de saída 0.
  • Com tarefas → Exibir contagens de cada estado (processed / completed / partial / failed) e lista de arquivos modificados.
  • Após o processamento, não manter sessão zmx.

Observações

  • Não pular ou reordenar as etapas do plano.
  • Regras de escrita de resultados, ordem dos campos YAML, tratamento de estado vazio, e fluxo de backup de erros de análise conforme references/yaml-schema.md.

Habilidades Relacionadas