loselen/test-me

O que test-me faz?

Verifique um resultado com uma tarefa que exige exatamente a habilidade que o resultado nomeia, depois aja com base no que a resposta mostra.

Baseado em: avaliação formativa (Black & Wiliam 1998), perguntas-charneira (Wiliam 2011), alinhamento construtivo (Biggs 1996), produção sobre reconhecimento (McDaniel et al. 2007), tarefas generativas (Fiorella & Mayer 2016), rubricas (Jonsson & Svingby 2007), feedback elaborado (Shute 2008; Hattie & Timperley 2007), andaime contingente e escadas de dicas (Wood et al. 1976; Aleven et al. 2016), análise de bugs (Brown & Burton 1978), critérios de maestria (Kelly et al. 2015).

Banco de dados: execute o script incluso a partir da raiz do projeto do aluno (a pasta onde o chat foi iniciado); ele mantém os dados em ./.learn/learn.db. ${CLAUDE_SKILL_DIR} é a pasta deste skill; o Claude Code a preenche automaticamente, e outros agentes devem usar o caminho da pasta que contém este SKILL.md.

1. Projete a atividade

Combine a tarefa com o verbo do resultado: se diz "explique", peça uma explicação; "resolva" ou "escreva", um problema inédito com detalhes superficiais diferentes da lição; "depure", um trabalho com falhas para corrigir.

Planeje 2–3 itens, fornecidos um por mensagem:

1. Item-charneira: uma pergunta de múltipla escolha ou "preveja o que acontece", onde cada opção errada corresponde a uma concepção errônea específica. A resposta correta deve ser difícil de adivinhar.
2. Item de produção: o aluno produz a própria resposta em um novo problema (transferência próxima).
3. (opcional) Item generativo: explique o porquê, encontre o erro ou aplique a uma situação ligeiramente diferente.

Nunca reutilize um item da lição ou de uma tentativa anterior.

2. Avalie cada resposta

1. Pergunte "Qual sua confiança: 1 chute, 2 razoavelmente certo, 3 certo?" logo após a resposta.
2. Julgue com base em uma rubrica de 2 a 4 critérios extraída do padrão do resultado (ex.: resultado correto, raciocínio válido, termos certos). Veredito: correto, parcial ou incorreto.
3. Se estiver errado, classifique o erro: deslize, lacuna (pré-requisito ausente) ou concepção errônea (uma regra errada consistente).

3. Forneça feedback

Seja breve, sobre o trabalho, e responda a três perguntas:

• O que funcionou: uma coisa específica, citando a resposta do aluno.
• O que está errado: a questão mais importante, no nível do método, não apenas da resposta final.
• Próximo passo: uma ação concreta.

Se o aluno estava confiante e errou, diga claramente ("você tinha certeza, e eis por que falha"); essas correções são as mais eficazes.

Em uma resposta errada, dê um degrau de dica por nova tentativa, nunca pulando para a solução:

1. Dica de apontamento: "olhe para a etapa 2 novamente"
2. Dica de princípio: "qual regra se aplica quando ...?"
3. Uma etapa parcialmente resolvida
4. Solução completa, então um novo item paralelo que o aluno deve resolver sem ajuda

4. Registre cada tentativa

Após avaliar cada resposta, salve-a (uma linha por tentativa de item):

python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" attempt '{"outcome_id": 7, "activity": "<o item>", "answer": "<resposta do aluno>", "verdict": "correct", "feedback": "<breve: tipo de erro, nível de dica usado, confiança, o que você disse>"}'

Use um heredoc na entrada padrão se o texto contiver aspas estranhas.

5. Decida

O resultado é atingido quando todas as condições a seguir são verdadeiras:

• os últimos 3 itens seguidos estavam corretos
• pelo menos um deles era um item de produção ou transferência
• nenhum deles precisou do degrau de dica 4
• o aluno deu pelo menos uma explicação correta com confiança 2 ou 3

Então marque:

python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" met '{"outcome_id": 7}'

Isso salva a data em que o resultado foi atingido. O resultado diz quantos resultados faltam no nó. Devolva o controle para o teach-me.

Se não foi atingido, escolha uma rota e devolva o controle para o teach-me:

• deslize → mais um item novo
• concepção errônea → reensine tornando o conflito visível, depois uma nova atividade
• lacuna → ensine ou adicione o pré-requisito ausente (create-map)
• 3+ atividades falhadas no mesmo resultado → o resultado é grande demais; divida a etapa e ensine em partes menores

Armadilhas

• Perguntas de reconhecimento quando o resultado pede produção.
• Opções de múltipla escolha que não revelam nada sobre como o aluno pensa.
• Declarar maestria após uma resposta correta.
• Reutilizar itens, fazendo o aluno lembrar em vez de pensar.
• Dar a resposta no primeiro erro.
• Listar todos os erros de uma vez. Corrija o mais importante primeiro.