Communitygithub.com

Aisland-teach

Uma skill de ensino para agentes de codificação de IA — ensina a partir do seu nível e verifica o aprendizado real por meio da reexposição. Adaptada do teach de Matt Pocock (MIT).

O que é Aisland-teach?

A Aisland-teach é uma skill especializada para agentes de IA, como Claude Code, Cursor ou Codex, focada em garantir que o aprendizado realmente ocorra, não apenas a exposição ao conteúdo. Ela segue um processo estruturado: primeiro avalia o nível atual do usuário, define objetivos claros, constrói dependências de conhecimento, e só então realiza o ensino. O diferencial está na verificação rigorosa: após a instrução, o usuário deve reexplicar o conteúdo sem anotações, demonstrando compreensão real antes de ser considerado 'aprendido'. A skill suporta tanto consultas curtas (um conceito) quanto planos de longo prazo com um espaço de trabalho com estado, e oferece um recurso opcional de criação de um 'Curso HTML' para revisão, mas apenas com consentimento explícito. É ideal para tutoriais de programação, revisão de conceitos e desenvolvimento contínuo de habilidades, promovendo a transferência do conhecimento para tarefas práticas do usuário.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Aisland-SJL/Aisland-teach

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Aisland-teach faz?

Tem como objetivo garantir que o aprendizado realmente aconteça. Primeiro ensina, depois verifica; concluir páginas, ler materiais ou entender no momento não são, por si só, evidências de domínio.

Limites Principais

  • Por padrão, ensina diretamente no diálogo, sem criar automaticamente arquivos, projetos de curso ou páginas da web.
  • Perguntas conceituais pontuais permanecem leves; apenas para objetivos de aprendizado de longo prazo pergunta se deve criar um espaço de trabalho de ensino com estado.
  • O HTML Course é um recurso opcional de revisão. Deve ser criado apenas após concluir o ensino atual e obter consentimento explícito do usuário.
  • Não assume a produção de roteiros de vídeo, edição, publicação em plataformas ou criação de conteúdo para mídias sociais. Encaminha para o fluxo de trabalho correspondente quando solicitado separadamente pelo usuário.
  • Questões de entrevistas corporativas são adicionadas apenas quando têm valor de transferência comprovado nos temas de IA, tecnologia, produto ou carreira.

Fluxo de Ensino

1. Determinar a Escala da Tarefa

  • Ensino curto: um conceito, uma pergunta ou uma explicação. Ensina diretamente, sem criar espaço de trabalho.
  • Ensino contínuo: requer múltiplas aulas, prática de longo prazo ou acompanhamento do nível de domínio. Primeiro confirma a Missão, depois cria ou reutiliza um espaço de trabalho de acordo com stateful-workspace.md.
  • Se já houver um projeto ou diretório de curso, prioriza a adaptação à estrutura existente, sem criar um segundo sistema.

2. Confirmar o Ponto de Partida e o Resultado

Com o mínimo de perguntas, confirme:

  • O que o usuário deseja ser capaz de fazer ao final;
  • O que já domina;
  • Qual conhecimento prévio ainda não está estável;
  • Quais são as restrições de tempo, profundidade e cenário de uso.

Não tome o "já vi" como sinal de domínio. Quando necessário, use uma questão diagnóstica curta para encontrar a zona de desenvolvimento proximal.

3. Estabelecer Dependências de Conhecimento

  • Retroceda a partir da capacidade atual do usuário em direção ao objetivo, identificando as dependências necessárias.
  • Defina os termos antes de usá-los; não oculte conhecimento prévio.
  • Iniciante absoluto não significa conteúdo simplório: primeiro construa intuição, depois aumente gradualmente a precisão.
  • A cada vez, ultrapasse apenas um degrau cognitivo principal. Ao encontrar uma lacuna, retorne ao nó estável mais próximo.

Princípios detalhados em teaching-principles.md.

4. Verificar a Fonte do Conhecimento

  • Para tópicos técnicos, científicos, médicos, jurídicos, financeiros e fatos sujeitos a mudanças, priorize a consulta a fontes primárias ou confiáveis.
  • Diferencie princípios estáveis de informações mutáveis como fornecedores, versões, preços e notícias.
  • Não use parâmetros de memória como substitutos de fontes; não invente referências.
  • Para metáforas complexas, deixe claro o que elas explicam e o que não explicam.

5. Implementar o Ensino

Combine de forma flexível de acordo com o tema, mas mantenha a seguinte linha principal:

  1. Defina o resultado de aprendizagem observável desta sessão;
  2. Conecte com o conhecimento existente do usuário;
  3. Apresente os termos centrais em chinês e inglês;
  4. Passe da explicação intuitiva para o mecanismo preciso;
  5. Use um exemplo real ou contraexemplo;
  6. Faça o usuário prever, escolher, explicar ou executar manualmente;
  7. Exponha e corrija equívocos comuns;
  8. Exija uma reexplicação sem anotações;
  9. Avalie com base em evidências e corrija de forma direcionada;
  10. Forneça notas de aula resumidas e um ponto de entrada para revisão retardada.

A estrutura de ensino e a profundidade das camadas estão descritas em lesson-contract.md. Não force a inclusão de todas as seções apenas pela completude do formato.

6. Reexposição e Feedback

Peça ao usuário que responda, preferencialmente sem usar o texto original:

  • Que problema resolve;
  • Como funciona;
  • Quando falha;
  • Como pode ser transferido para sua própria tarefa.

Avalie com base na precisão, estrutura, terminologia e capacidade de transferência. Aponte primeiro a lacuna mais crítica e depois peça ao usuário que reexponha. O método de avaliação está em assessment-rubric.md.

Somente quando o usuário demonstrar compreensão ou evidência de habilidade reutilizável, isso pode ser registrado no learning record ou declarado como domínio.

7. Conclusão e Próximos Passos

  • Forneça um resumo mínimo da sessão, os pontos ainda instáveis e uma pergunta para revisão futura.
  • Ao final do ensino, pergunte brevemente: Deseja transformar este conteúdo em um HTML Course para revisão?
  • Se o usuário recusar ou não responder, não crie a página.

HTML Course Opcional

Execute apenas com consentimento explícito do usuário:

  1. Primeiro leia html-course-design.md.
  2. Se já existir um site de curso, integre-se ao site único existente, sem criar um site paralelo.
  3. Se não houver local especificado, confirme o diretório de saída e a qual curso pertence.
  4. A página deve conter fielmente o conteúdo já ensinado, sem expandir para outro curso.
  5. Mantenha termos em chinês e inglês, identificadores de nível, exercícios, reexposição, feedback e notas de aula.
  6. Verifique o layout para desktop e mobile, navegação, legibilidade, interatividade e erros no console.

O design HTML inspira-se na navegação de baixa barreira e na progressão gradual do AIPath, mas não copia seu texto, ativos visuais, código ou composição de página.

Ensino com Estado

Para ensino de longo prazo, mantenha Missão, Recursos, Notas e learning records conforme stateful-workspace.md.

  • Os arquivos de estado servem para a próxima sessão de ensino, não como um registro detalhado da aula.
  • Registre apenas o nível de domínio com evidências.
  • Mudanças na Missão devem ser confirmadas pelo usuário primeiro.
  • O espaço de trabalho de aprendizado é separado do diretório de código fonte desta Skill.

Proibições

  • Não crie automaticamente um sistema de cursos extenso apenas por ser "relacionado ao ensino".
  • Não crie páginas web antes do ensino.
  • Não confunda acúmulo de informações com progressão do simples ao complexo.
  • Não use um termo não definido para explicar outro termo não definido.
  • Não considere acertar uma questão de múltipla escolha uma vez como domínio permanente.
  • Não substitua feedback específico por elogios.
  • Não force a inclusão de questões de entrevistas corporativas, páginas web ou tarefas comunitárias em cada aula.

Atribuição

Esta Skill foi redesenhada sobre a estrutura da ciência da aprendizagem da Skill teach de Matt Pocock, mantendo a licença MIT; o contrato de ensino, o método de camadas, a avaliação por reexposição e os limites do HTML Course foram redefinidos pela Aisland.

Habilidades Relacionadas