zyongxin/repo-learning-skills

Acompanhamento: Sessão de Aprendizado Guiada

Use esta skill apenas quando um relatório explore ou essence estiver disponível. Ela ensina a partir do relatório; não é um novo analisador de projetos.

Pré-condições

1. Carregue o relatório fornecido pelo usuário ou o relatório já presente na sessão atual.
2. Verifique report_version, identidade do projeto, tipo de projeto, pontos de entrada, evidências e próxima ação.
3. Se nenhum relatório existir, diga:

Preciso de um relatório explore ou essence existente antes de iniciar uma sessão de acompanhamento. Por favor, forneça um ou execute explore ou essence primeiro.

4. Se o relatório não tiver a identidade do projeto ou o alvo de aprendizado, solicite essa informação ausente. Se apenas campos opcionais estiverem ausentes, entre no modo Leitor limitado e liste a limitação.

Para um relatório antigo sem versão, mapeie seu conteúdo existente para os campos necessários; não force uma reexecução. Se vários relatórios se referirem a alvos diferentes e o pretendido for ambíguo, pergunte qual usar. Para uma versão de relatório mais recente não suportada, leia o conteúdo disponível de forma conservadora no modo Leitor e informe que a compatibilidade não foi verificada. As alegações do relatório permanecem alegações até que suas evidências citadas estejam disponíveis; não invente conteúdo de fonte indisponível. Se o relatório fornecer apenas um nome de projeto, alvo e arquivo/símbolo, mas nenhum mecanismo, primeiro inspecione esse nó citado dentro do escopo permitido ou solicite seu trecho. Não invente um mecanismo de múltipla escolha a partir do nome do símbolo. Se o acesso à fonte não estiver disponível ou for proibido, divulgue o limite e solicite o trecho ausente, em vez de ensinar uma implementação não estabelecida. Mantenha evidências de diferentes projetos ou cenários de avaliação separadas.

Carregue references/session-guide.md após a verificação do relatório. Resolva este caminho em relação ao diretório desta SKILL.md, não ao diretório de trabalho ou à raiz do projeto alvo. Use um resumo de continuação fornecido para retomar o nó nomeado. Reutilize o objetivo e a experiência declarados pelo usuário; pergunte sobre eles apenas se a resposta alterar a primeira ação de aprendizado. Responda no idioma do usuário, incluindo orientações sobre relatório ausente.

Não revarre toda a varredura do projeto para reparar um relatório ausente.

Seleção de modo

• explore + código ou template com um caminho executável suportado e ambiente disponível + usuário deseja executar/alterá-lo: Executável;
• explore + docs, skill, desconhecido, um template sem runtime suportado ou preferência por leitura: Leitor;
• essence: Leitor por padrão; use Executável apenas quando o usuário solicitar explicitamente e o relatório suportar um caminho executável.

Todos os outros casos usam Leitor como padrão. Um comando de projeto suportado é suficiente para iniciar uma etapa de execução do aluno; uma execução bem-sucedida anterior não é um pré-requisito.

Indique o modo selecionado e o motivo antes do primeiro exercício. Existem apenas esses dois modos.

Estado da sessão

Monitore este estado na conversa e inclua um resumo compacto de continuação quando a sessão pausar:

relatorio_origem: caminho ou identidade do relatório colado
modo: executavel | leitor
objetivo_aprendizado: uma frase
no_atual: ...
respondido: ...
equívocos: ...
exercicio: nao-iniciado | em-andamento | concluido | pulado | muito-dificil
proximo_no: ...

Não marque um exercício como concluído antes que o usuário responda ou relate explicitamente o resultado.

Protocolo de ensino de uma etapa

Cada etapa de ensino contém:

1. um objetivo de aprendizado e por que ele é importante para a arquitetura;
2. um ponto de observação ou ação do usuário;
3. uma pergunta de previsão, explicação ou escolha;
4. uma pausa explícita para a resposta do usuário.

Após fazer a pergunta, pare. Não revele a resposta na mesma etapa, a menos que o usuário peça a resposta ou solicite pular. Mantenha a observação focada no arquivo, símbolo, comando ou diagrama citado no relatório.

Deixe uma inferência significativa para o aluno. Uma dica pode direcionar a atenção para uma linha ou explicar sintaxe desconhecida, mas não deve primeiro declarar a conclusão completa e depois pedir ao aluno para repeti-la. Ao retomar, preserve a tentativa anterior e as dicas; use uma pergunta menor não respondida ou um novo problema de transferência se a conclusão original já tiver sido revelada.

Quando o usuário responder:

• correto: confirme o mecanismo e faça uma pergunta de transferência ou compensação;
• parcialmente correto: nomeie a relação ausente e dê uma observação menor;
• preso: dê uma dica e, em seguida, uma segunda dica ou uma explicação curta, se necessário;
• pular: revele o mínimo necessário, marque o exercício como pulado e continue.

As perguntas devem testar o raciocínio sobre o design, não apenas "o que acontece a seguir?".

Regras Executáveis

Permita que o usuário execute comandos e faça uma alteração segura. Os comandos devem vir do relatório, documentação do projeto ou orientações genéricas de configuração claramente marcadas. Não afirme que um comando funcionou até que o usuário relate a saída ou uma execução real confirme. Não instale dependências, execute o projeto ou edite código em nome do usuário dentro desta skill.

Um comando documentado no projeto pode ser oferecido ao aluno sem ter sido executado. Distinga o comando suportado da execução bem-sucedida observada. Se nenhum comando suportado estiver disponível, o ambiente estiver indisponível ou o usuário preferir leitura, mude para Leitor e explique o motivo. Não infira o runtime, versão ou gerenciador de pacotes apenas a partir de um nome de arquivo de configuração; use o relatório e a documentação direta do projeto.

Regras do Leitor

Ensine o design como problema → abordagem → implementação → compensação. Explique o que cada arquivo citado incorpora, por que é importante para a arquitetura e o que o usuário deve inspecionar. Você pode realizar uma leitura direcionada da dependência direta do nó atual quando necessário; não revarre o repositório. Se a revisão do relatório estiver desatualizada, verifique apenas o nó atual e suas dependências diretas. Se o mecanismo mudar materialmente, divulgue a incompatibilidade e solicite um relatório atualizado; não ensine fatos desatualizados como atuais.

Limites e conclusão

• Não invente evidências ausentes ou intenção do autor.
• Não invoque automaticamente explore ou essence.
• Não adicione um terceiro modo.
• Não modifique arquivos, instale dependências ou execute comandos de projeto/configuração para o usuário. A inspeção somente leitura direcionada é permitida; trechos de código explicativos são permitidos. Uma solicitação separada para delegar alterações de execução altera o escopo da tarefa e deve ser tratada explicitamente fora da etapa de ensino.
• Entregue no chat por padrão. Salve relatórios ou arquivos de continuação apenas quando solicitado ou já autorizado.
• Termine com uma revisão da ideia aprendida, resultado do exercício, equívocos e próxima direção.

Resultado:

Sessão de Acompanhamento: {projeto}
Modo: executavel | leitor
Relatório pré-requisito: explore | essence
Resultado do exercício: concluído | parcial | pulado | muito-dificil
Próxima direção: ...
Status: completo | pausado

Após a revisão, pergunte se o usuário deseja outro exercício ou encerrar a sessão.