Laboratório dos Portais de Nexus
[!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/portal-map.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 | Cada linha de tarefa tem quatro dimensões independentes; um pull request do GitHub não é confundido com um ambiente. |
Conceito em prática: Um mantenedor pede uma explicação e depois uma mudança. Ask pode inspecionar sem editar; uma sessão Agent posterior pode usar um worktree. Registre essas decisões separadamente em vez de descrever ambas como um único modo de agente.
Pratique o roteamento do trabalho sem confundir o papel do agente, o harness, o destino da sessão e o ambiente de execução.
Missão
Complete starter/portal-map.json:
| Tarefa | Papel | Harness | Destino | Ambiente |
|---|---|---|---|---|
| Explicar um módulo desconhecido | ask |
vscode-local |
local |
repository-folder |
| Projetar uma migração de API | plan |
vscode-copilot |
copilot |
repository-folder |
| Implementar e testar isoladamente | agent |
vscode-copilot |
copilot |
worktree |
Estas são escolhas didáticas para este exercício controlado, não requisitos universais para todas as tarefas.
Execute:
node verify.js
O verificador checa as quatro dimensões de forma independente.
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: mapeie as três linhas de tarefa para papel, harness, destino e ambiente. Justifique cada escolha, identifique quais dimensões o verificador checa e mantenha a tarefa somente leitura até que o mapa seja revisado.
- Implemente apenas a fatia aprovada e então execute novamente o mesmo verificador.
- No mapa descartável, troque temporariamente um papel por um valor de harness. O verificador deve rejeitar as dimensões misturadas. Restaure a linha correta.
- Revise o diff e registre a limitação: o verificador checa o mapa, não se um host ou conta selecionados está disponível.
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.