Laboratório da Convergência dos Três Reinos
[!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/workflow.json, 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 grafo preserva descobertas, design, verificação, pull request, relatório de avaliação e decisão humana em ordem. |
Conceito em prática: Um desenvolvedor local, um trabalhador na nuvem e um agente de runtime incorporado têm identidades e saídas diferentes. O mantenedor final precisa tanto da evidência de implementação quanto da avaliação em runtime antes de decidir.
Conecte desenvolvimento local, trabalho no repositório remoto e um runtime incorporado em um único grafo de entrega rastreável.
Missão
Complete starter/workflow.json com seis etapas ordenadas:
| Fase | Ator | Papel do agente | Harness | Destino | Ambiente | Superfície de revisão |
|---|---|---|---|---|---|---|
| Ask | Aprendiz | ask |
vscode-local |
local |
repository-folder |
— |
| Plan | Aprendiz | plan |
vscode-copilot |
copilot |
repository-folder |
— |
| Implementação | GitHub Copilot | agent |
vscode-copilot |
copilot |
worktree |
— |
| Implementação na nuvem | GitHub Copilot | agent |
github-copilot-cloud-agent |
cloud |
ephemeral-github-environment |
— |
| Avaliação em tempo de execução | Aplicação com SDK | custom-agent |
github-copilot-sdk |
application |
application-runtime |
— |
| Revisão | Mantenedor | nenhum | não se aplica | não se aplica | não se aplica | github-pull-request |
Cada etapa deve declarar o ator separadamente de:
- papel do agente, quando houver um agente envolvido;
- harness;
- destino;
- ambiente;
- quais artefatos consome;
- seu limite de confiança;
- pelo menos um item concreto de evidência.
A etapa de revisão humana deixa intencionalmente nulas as dimensões exclusivas de agentes, em vez de forçar um pull request a se passar por um harness ou ambiente.
Execute:
node verify.js
Use artefatos em papel quando o acesso ao agente na nuvem ou ao SDK não estiver disponível. Rotule a alternativa de reserva em vez de fabricar evidência de execução.
Execução guiada
- Execute o verificador intocado e registre o estado inicial esperado.
- Peça uma explicação fundamentada nas fontes do código e das verificações relevantes.
- Planeje: complete o contrato de seis estágios usando as dimensões de ator e artefato fornecidas. Explique cada aresta consome/produz, limite de confiança e item de evidência. Mantenha os campos só de agente em null para a revisão humana.
- Implemente apenas a fatia aprovada e então execute novamente o mesmo verificador.
- Dê à etapa de revisão humana um harness de agente e confirme que o verificador rejeita a confusão. Restaure o limite de revisão distinto.
- Revise o diff e registre a limitação: completar o contrato do fluxo de trabalho não é uma entrega de produção. Registre os estágios na nuvem e do SDK não executados como alternativas em papel, nunca como observações fabricadas.
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.