teach

Quando Usar

Use quando este fluxo de trabalho corresponder à solicitação do usuário: Ensinar ao usuário uma nova habilidade ou conceito, dentro deste espaço de trabalho.

Fonte: mattpocock/skills (MIT). O usuário pediu para você ensiná-lo algo. Esta é uma solicitação com estado - eles pretendem aprender o tópico ao longo de várias sessões.

Espaço de Trabalho de Ensino

Trate o diretório atual como um espaço de trabalho de ensino. O estado do aprendizado deles é capturado neste diretório em vários arquivos:

• MISSION.md: Um documento que captura o motivo pelo qual o usuário está interessado no tópico. Isso deve ser usado para fundamentar todo o ensino. Use o formato em MISSION-FORMAT.md.
• ./reference/*.html: Um diretório de materiais de referência. Estes são os aprendizados compactados das lições - guias rápidos, algoritmos de referência, sintaxe, poses de ioga, glossários. Eles são as unidades brutas de aprendizado. Devem ser documentos bonitos que imprimem bem e são projetados para referência rápida.
• RESOURCES.md: Uma lista de recursos que podem ser explorados para fundamentar seu ensino em conhecimento contextual, ou para adquirir conhecimento e sabedoria. Use o formato em RESOURCES-FORMAT.md.
• ./learning-records/*.md: Um diretório de registros de aprendizado, que capturam o que o usuário aprendeu. Estes são vagamente equivalentes a registros de decisão arquitetônica no desenvolvimento de software - eles capturam lições não óbvias e insights chave que podem precisar ser revisados posteriormente, ou que impulsionam sessões futuras. Estes devem ser usados para calcular a zona de desenvolvimento proximal. Eles são intitulados 0001-<dash-case-name>.md, onde o número incrementa a cada vez. Use o formato em LEARNING-RECORD-FORMAT.md.
• ./lessons/*.html: Um diretório de lições. Uma lição é uma saída HTML única e autônoma que ensina uma coisa com escopo restrito, ligada à missão. Esta é a unidade primária de ensino neste espaço de trabalho.
• ./assets/*: Componentes reutilizáveis compartilhados entre as lições. Veja Assets.
• NOTES.md: Um bloco de notas para você anotar preferências do usuário ou notas de trabalho.

Filosofia

Para aprender em um nível profundo, o usuário precisa de três coisas:

• Conhecimento, capturado de recursos de alta qualidade e alta confiança
• Habilidades, adquiridas através de lições interativas altamente relevantes elaboradas por você, com base no conhecimento
• Sabedoria, que vem da interação com outros aprendizes e praticantes

Antes que o RESOURCES.md esteja bem preenchido, seu foco deve ser encontrar recursos de alta qualidade que ajudem o usuário a adquirir conhecimento. Nunca confie em seu conhecimento paramétrico.

Alguns tópicos podem exigir mais habilidades do que conhecimento. Aprender mais sobre física teórica pode ser mais baseado em conhecimento. Para ioga, mais baseado em habilidades.

Fluência vs. Força de Armazenamento

Você deve ter cuidado para dividir entre dois tipos de aprendizado:

• Força de fluência: recuperação de conhecimento no momento
• Força de armazenamento: retenção de conhecimento a longo prazo

A fluência pode dar ao usuário uma sensação ilusória de maestria, mas a força de armazenamento é o objetivo real. Tente projetar lições que construam retenção a longo prazo através de dificuldade desejável:

• Usando prática de recuperação (recordar da memória)
• Espaçamento (distribuindo a prática ao longo do tempo)
• Intercalação (misturando tópicos diferentes, mas relacionados, na prática - apenas para prática de habilidades)

Lições

Uma lição é a principal coisa que você produz — a unidade na qual o conhecimento e as habilidades chegam ao usuário. Cada lição é um arquivo HTML autônomo, salvo em ./lessons/ e intitulado 0001-<dash-case-name>.html onde o número incrementa a cada vez.

Uma lição deve ser bonita — tipografia e layout limpos e legíveis — pois o usuário retornará a elas mais tarde para revisar. Pense em Tufte.

A lição deve ser curta e completável muito rapidamente. A memória de trabalho dos aprendizes é muito pequena, e precisamos permanecer dentro dela. Mas cada lição deve dar ao usuário uma única vitória tangível na qual ele possa se basear. Ela deve estar diretamente ligada à missão e estar na zona de desenvolvimento proximal do usuário.

Se possível, abra o arquivo da lição para o usuário executando um comando CLI.

Cada lição deve vincular via âncoras HTML a outras lições e documentos de referência.

Cada lição deve recomendar uma fonte primária para o usuário ler ou assistir. Este deve ser o recurso de mais alta qualidade e mais confiável que você encontrou sobre o tópico.

…