Laboratório das Skills de Algora
[!TIP] Baixe o ZIP do aluno ou copie todo este laboratório para uma pasta não utilizada. 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/skills/evidence-report/SKILL.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 arquivo tem metadados válidos, um caso de uso restrito e nenhuma instrução para inventar resultados bem-sucedidos. |
Conceito em prática: Uma skill de relatório de evidência é útil após uma mudança de código com um comando de teste. Um pedido para pensar um nome não deve acionar um relatório de verificação falso só porque a skill existe.
Construa uma skill pequena e reutilizável para relatórios de conclusão baseados em evidência primeiro.
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 a skill seja descoberta em .github/skills/.
Missão
Complete starter/.github/skills/evidence-report/SKILL.md:
- mantenha o frontmatter YAML com
nameedescription; - adicione etapas para executar a verificação solicitada;
- exija o registro do comando, do código de saída e do resultado observado;
- proíba alegações de sucesso sem fundamento.
De starter/, execute node ../verify.js. Registre evidência separada de que o harness selecionado descobriu ou invocou a skill.
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 quando o relatório de evidência é relevante e quando não é. Especifique o procedimento para executar uma verificação existente e relatar a saída real, incluindo verificações bloqueadas ou com falha.
- Implemente apenas a fatia aprovada e então execute novamente o mesmo verificador.
- Remova o requisito de resultado observado e confirme que a verificação estrutural o rejeita. Restaure a regra e compare uma solicitação dentro do escopo com uma fora dele.
- Revise o diff e registre a limitação: o verificador checa o conteúdo da skill; a descoberta e a invocação reais dependem do harness selecionado.
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.