Laboratório dos Agentes de Stellaris
[!TIP] Baixe o ZIP do aluno ou copie todo este laboratório para uma pasta não usada. Leia a configuração e as etapas opcionais do GitHub primeiro.
Antes de executar qualquer coisa
| Item | Contrato |
|---|---|
| Runtime | Node 24; as integrações ao vivo são separadas |
| Arquivos para inspecionar | starter/.github/agents/test-scout.agent.md, verify.js |
| Diretório do verificador | Raiz do kit extraído: node verify.js; de starter/: node ../verify.js |
| Estado inicial | Starter inacabado é rejeitado; preserve o diagnóstico |
| Evidência final | O perfil tem busca e uma ferramenta de comando focada, não uma ferramenta de edição, e um prompt de handoff concreto. |
Conceito em prática: Um test scout pode inspecionar e executar um teste delimitado e depois recomendar um caso ausente. Um implementador separado é dono das edições de código; o handoff transfere um plano revisado, não autoridade ilimitada.
Defina um agente personalizado focado usando o formato atual de personalização .agent.md.
Isole o exercício
Copie este laboratório para um local descartável e abra starter/ como raiz do workspace. Inicie uma nova sessão para que .github/agents/test-scout.agent.md seja descoberto a partir da raiz correta.
Missão
Complete starter/.github/agents/test-scout.agent.md. Ele deve incluir campos de frontmatter para name, description e tools e, depois, instruir o agente a:
- inspecionar os testes existentes antes de recomendar alterações;
- permanecer somente leitura quanto a edições no código-fonte e recomendar apenas alterações voltadas a testes;
- executar o menor comando de teste relevante;
- relatar evidências e falhas restantes.
- transferir um plano concreto de testes ao papel integrado Agent para implementação.
De starter/, execute node ../verify.js. Registre evidência separada de que o agente aparece no harness selecionado e de que seu handoff está disponível onde for suportado.
Execução guiada
- Execute o verificador intocado e registre o estado inicial esperado.
- Peça uma explicação fundamentada na fonte do código e das verificações relevantes.
- Planeje: defina os metadados de test-scout e uma lista mínima de ferramentas consistente com o verificador. Mantenha as recomendações focadas em testes, preserve a intenção de somente leitura do código-fonte e exija um handoff revisado para Agent.
- Implemente apenas a fatia aprovada e então execute novamente o mesmo verificador.
- Adicione temporariamente uma ferramenta de edição ao perfil copiado. Verifique a rejeição e depois restaure a lista restrita de ferramentas.
- Revise o diff e registre a limitação: uma ferramenta de comando ainda pode ter efeitos colaterais. A intenção de somente leitura não é um sandbox; revise os comandos de teste exatos e as permissões.
Conclusão e redefinição segura
- O comportamento exigido e seu caso negativo têm evidência observada.
- O resultado distingue a verificação local do comportamento ao vivo do host/runtime.
- Nenhuma credencial, arquivo não relacionado ou serviço foi alterado.
- A evidência está salva antes de redefinir o starter copiado.
Use uma nova extração para outra tentativa, ou restaure apenas os arquivos nomeados a partir de uma linha de base Git criada nesta cópia. Nunca aplique um comando de redefinição da raiz do currículo a partir de um projeto diferente.
Continue com a aventura e a rubrica.