5.1 KiB
Parte 4: Desenvolvimento Multi-Agente
Tarefa 1: Agent Hooks — Portão de Testes
Agent hooks executam comandos shell em pontos-chave do ciclo de vida durante sessões de agente. Vamos adicionar um Stop hook com escopo de workspace que bloqueia todos os agentes — nenhum agente pode finalizar até que todos os testes passem.
Passos:
- Abra a pasta
.github/hooks/ - Prompt: Adicione um agent hook que execute os testes e bloqueie o agente de finalizar se algum teste falhar
- O hook deve ser um arquivo JSON em
.github/hooks/(ex:stop-test-gate.json), não dentro de nenhum arquivo de agente individual.
✅ Resultado: Todo agente agora tem uma rede de segurança — ele vai continuar trabalhando até que todos os testes passem antes de devolver o controle.
Tarefa 2: Novo Padrão de Bingo (Orientado por TDD)
Use o agente TDD para adicionar um padrão de bingo "Four Corners". O stop hook do workspace que você configurou vai garantir a disciplina de testes — todo agente deve deixar os testes passando antes de devolver o controle.
Passos:
- Novo chat com agente:
TDD - Adicione um padrão de vitória "Four Corners" no bingo — todos os quatro quadrados dos cantos (superior-esquerdo, superior-direito, inferior-esquerdo, inferior-direito) devem estar marcados
- Observe o TDD orquestrar:
- TDD Red escreve testes que falham para a detecção de Four Corners
- Revise os novos testes no test runner do VS Code
- TDD Green implementa o código mínimo para passar — o stop hook dispara, continua se os testes falharem
- TDD Refactor limpa a implementação
- Clique em qualquer sub-agente enquanto ele executa para ver seu contexto e instruções
- Revise o resumo das mudanças
✅ Resultado: Ciclo TDD orquestrado com portão de testes automático — sem handoffs manuais entre agentes.
Tarefa 3: Verifique com Agent Debug Logs
Inspecione o que aconteceu por baixo dos panos — o hook disparou? Como os agentes se comunicaram?
Passos:
- Verifique se o hook carrega: abra o canal de saída GitHub Copilot Chat Hooks (painel Output → dropdown de canal)
- Abra Agent Debug Logs: ícone de engrenagem (⚙️) na view do Chat → Show Agent Debug Logs
- Aba Logs: filtre por eventos de execução do hook durante o ciclo TDD
- Agent Flow Chart: visualize a orquestração TDD → Red → Green → Refactor
- Aba Summary: revise o total de chamadas de ferramenta e uso de tokens
Bônus: Clique no ícone ✨ sparkle para anexar eventos de debug a um novo chat, depois pergunte: /troubleshoot o Stop hook disparou durante o ciclo TDD?
✅ Resultado: Observabilidade completa da orquestração multi-agente e execução de hooks.
Tarefa 4: Card Deck Shuffle (Orientado por Design)
Divida fluxos de trabalho de agentes em áreas de foco específicas, como design-first.
Passos:
- Novo chat com agente:
Pixel Jam - Novo modo: Card Deck Shuffle. Todo jogador abre o jogo → toca → recebe uma carta aleatória com uma pergunta.
- O agente itera na UI
- Dê follow-up para funcionar como você quer:
- Adicione esquerda/direita (falha, sucesso)
- Puxe uma carta logo quando eu abrir
- Commit
Tarefa 5: Agente de Revisão de UX
Combine MCP, fluxos de trabalho personalizados e isolamento de sub-agentes em um agente para fluxos de trabalho poderosos. Foque em diferentes aspectos, como usabilidade, a11y, conformidade.
Passos:
- Novo chat com agente:
Pixel Jam: Execute a revisão - Mantenha o app aberto na pré-visualização do navegador do VS Code enquanto a revisão executa
- Acompanhe conforme ele revisa
- À parte: Abra
.github/agents/pixel-jam.agent.mdpara revisar o prompt
- À parte: Abra
- Contemple uma revisão profunda e detalhada
Bônus:
- Registre achados como issues no GitHub para depois
- Atribua issues críticas ao agente de código para corrigir
Bônus: Continue Explorando
- Corrija problemas da revisão de UX, delegados para agente em background ou cloud
- Adicione a possibilidade de ter múltiplos temas de perguntas para escolher
- Adicione compartilhamento social no estado de vitória
- Faça um app real para iOS ou full-stack?
✅ Parte 4 Completa!
Você aprendeu como:
- Adicionar agent hooks com escopo de workspace para impor portões de qualidade (Stop hook em todos os agentes)
- Usar TDD para orquestrar Red → Green → Refactor automaticamente
- Inspecionar comportamento do agente com Agent Debug Logs e Flow Charts
- Usar agentes design-first para desenvolvimento orientado por UI
- Executar agentes de revisão de UX para testes abrangentes
- Combinar múltiplos tipos de agentes para fluxos de trabalho complexos