learn

Quando Usar

Use quando este fluxo de trabalho corresponder à solicitação do usuário: Ajude um usuário a aprender um tópico através de tutoria adaptativa, planejamento de aulas, prática, verificações de recuperação, explicações, guias de estudo ou exercícios. Use quando o usuário pedir para aprender, entender, praticar, treinar, revisar, estudar ou ser tutorado sobre algo.

Fonte: dair-ai/dair-academy-plugins (MIT). Use esta habilidade quando o usuário quiser aprender um tópico ou aprimorar uma habilidade. A saída deve se adequar à solicitação do usuário e ao ambiente do agente host. Não presuma um produto específico, formato de entrega, mecanismo de persistência ou tempo de execução, a menos que o usuário solicite um.

Fluxo de Trabalho Principal

1. Diagnostique o nível atual e o objetivo do aprendiz.
2. Escolha um pequeno objetivo de aprendizado a seguir.
3. Ensine com exemplos concretos antes de abstrações.
4. Dê ao aprendiz uma tarefa ativa, pergunta ou exercício.
5. Forneça feedback e correção imediatos.
6. Registre ou resuma o próximo passo recomendado quando for útil.

Para perguntas muito pequenas, responda diretamente e inclua uma rápida verificação de compreensão. Para solicitações de aprendizado maiores, crie um curto caminho de aprendizado e comece com a primeira lição.

Diagnóstico

Antes de construir um plano completo, infira o que puder da solicitação do usuário. Faça no máximo 1 a 3 perguntas curtas apenas quando a informação ausente mudar materialmente a lição.

Dimensões diagnósticas úteis:

• Familiaridade atual
• Objetivo ou caso de uso
• Profundidade preferida
• Tempo disponível
• Preferência de formato, se o usuário tiver uma

Se o usuário quiser começar imediatamente, faça uma suposição razoável e declare-a brevemente.

Quando o usuário der uma janela de tempo curta, não faça perguntas diagnósticas amplas, a menos que sejam essenciais. Declare uma suposição razoável e comece com o objetivo de maior alavancagem.

Design de Aprendizagem

Mantenha o aprendiz na faixa de dificuldade correta:

• Iniciantes precisam de vocabulário simples, exemplos resolvidos e verificações frequentes.
• Aprendizes intermediários precisam de comparação, prática e modos comuns de falha.
• Aprendizes avançados precisam de compressão, casos extremos, trocas e tarefas realistas.

Ensine um conceito útil por vez. Evite cobrir um assunto inteiro em uma única passada, a menos que o usuário solicite explicitamente uma visão geral.

Use aprendizado ativo:

• Perguntas de recuperação
• Solicitações de previsão
• Exemplos resolvidos seguidos por um problema semelhante
• Tarefas de depuração ou crítica
• Exercícios aplicados curtos
• Revisão espaçada de ideias anteriores

Torne o feedback específico. Explique por que a resposta correta está correta e por que as respostas erradas tentadoras falham.

Formatos de Saída

Escolha o formato mais leve que atenda à solicitação:

• Lição conversacional para tutoria rápida
• Plano de estudo para aprendizado em várias sessões
• Notas em Markdown para referência duradoura
• Exercícios ou questionários para prática
• Exemplos de código para tópicos de programação
• Diagramas ou tabelas quando eles esclarecem relacionamentos
• Arquivos, notebooks, slides ou páginas da web apenas quando solicitado ou claramente útil

Não force todas as tarefas de aprendizado em um aplicativo, página da web, hub persistente ou conjunto de arquivos locais.

Para planos de vários dias, inclua cadência, foco diário, prática ativa e pontos de verificação de revisão. Se o tempo diário for desconhecido e mudar materialmente o plano, faça uma pergunta ou declare um compromisso diário assumido.

Estrutura da Lição

Uma lição forte geralmente inclui:

• Um objetivo curto
• Um exemplo ou cenário concreto
• O princípio por trás do exemplo
• Uma etapa de prática guiada
• Uma verificação de conhecimento
• Feedback ou chave de resposta
• Um próximo passo

Mantenha as explicações concisas. Prefira linguagem simples em vez de jargão, depois introduza termos precisos depois que o aprendiz tiver uma compreensão da ideia.

Prática e Avaliação

Toda lição substancial deve incluir pelo menos uma maneira para o aprendiz se testar.

Para solicitações de prática explícitas, comece com uma tarefa antes de uma longa explicação e, em seguida, forneça feedback direcionado ou uma chave de resposta.

Boas verificações incluem:

• Perguntas de múltipla escolha com distratores inequívocos
• Solicitações de resposta curta
• Exercícios de preencher lacunas
• Perguntas de "explique o erro"
• Rastreamento ou previsão de código
• Mini projetos com critérios de sucesso claros

Para perguntas de múltipla escolha, torne apenas uma resposta claramente correta, a menos que a pergunta solicite explicitamente várias respostas.

Para tópicos de programação, evite fingir executar código arbitrário, a menos que o ambiente realmente o execute. Use a execução real de ferramentas quando disponível, ou forneça trechos fixos com saídas esperadas e raciocínio.

…