CommunityEscrita e Ediçãogithub.com

AlbertFD / Criação de Provas Interativas

Gera quizzes interativos em HTML com explicações, citações reais e derivações passo a passo, adaptados a cinco níveis de dificuldade.

O que é Criação de Provas Interativas?

Esta skill transforma a geração de quizzes em uma ferramenta de aprendizado ativo. Diferente de questionários comuns, cada pergunta inclui uma explicação simplificada, derivações quantitativas detalhadas e citações verificáveis. O usuário define o nível de dificuldade (do básico ao nível de pesquisa), e a skill pesquisa fontes confiáveis para garantir precisão. O resultado é um arquivo HTML interativo, com renderização MathJax, verificação automática de respostas, revelação gradual de derivações e pontuação final. Ideal para educadores, estudantes e autodidatas que desejam testar e aprofundar conhecimento com integridade acadêmica.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add AlbertFD/AlbertFD-skills

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Criação de Provas Interativas

Uma boa prova faz duas coisas ao mesmo tempo: testa o que alguém sabe e ensina no momento em que algo é errado. A maioria dos quizzes gerados automaticamente faz apenas a primeira — uma pergunta nua, uma resposta certa, nada que ajude o aprendiz a entender por quê. Esta skill existe para fazer bem a segunda tarefa. Cada pergunta vem com uma explicação simplificada que o aprendiz pode realmente acompanhar, a equação ou derivação por trás dela quando o tópico é quantitativo, e uma citação real para que possa aprofundar e confiar na resposta.

O resultado é um único arquivo HTML interativo que o usuário pode abrir no navegador, responder no seu próprio ritmo, verificar-se, revelar derivações trabalhadas e pontuar. Deve parecer uma ferramenta de estudo bem-feita, não uma impressão.

A regra mais importante: pergunte a dificuldade antes de construir

A dificuldade muda tudo sobre a prova — o vocabulário, se você mostra uma derivação ou apenas afirma um resultado, quantos passos um problema tem, quanto você assume que o leitor já sabe. Portanto, você não pode escrever uma única boa pergunta até saber o nível. Pergunte ao usuário qual nível ele deseja antes de gerar a prova, usando a ferramenta AskUserQuestion com estas cinco opções:

  • Básico — primeira exposição. Linguagem simples, exemplos concretos, jargão mínimo, resultados apresentados sem derivação. Pense em um curioso iniciante ou início do ensino médio.
  • Intermediário — confortável com o básico. Apresenta a terminologia padrão e raciocínio simples de uma ou duas etapas. Pense em um bom aluno do ensino médio ou início da graduação.
  • Avançado — conhecimento sólido de trabalho. Problemas de múltiplas etapas, espera fluência com o formalismo central, derivações curtas mostradas. Pense em final de graduação.
  • Especialista — domínio profundo. Casos de borda não óbvios, conexões entre ideias, derivações completas esperadas. Pense em pós-graduação.
  • PhD / Pesquisa — fronteira do conhecimento. Suposições sutis, debates atuais, derivações rigorosas, citações da literatura primária. Pense em exame de qualificação ou seminário de pesquisa.

Se o usuário já mencionou um nível em sua mensagem ("me dê uma prova difícil nível PhD sobre..."), mapeie para a opção mais próxima e confirme em vez de perguntar novamente. Enquanto pergunta a dificuldade, é eficiente também confirmar o tópico (se estiver confuso) e quantas perguntas desejam (padrão 8) na mesma chamada AskUserQuestion — mas a dificuldade é a que você nunca deve pular.

Acertar o tópico

Leia o contexto antes de perguntar. O tópico pode já estar óbvio a partir da mensagem do usuário, das instruções do projeto, dos arquivos na pasta ou da conversa até agora. Se o usuário trabalha em uma área especializada (seu perfil ou CLAUDE.md geralmente diz isso), apresente exemplos no seu mundo em vez de genéricos — um físico recebe antimatéria e seções de choque, não "uma bola rolando ladeira abaixo", a menos que tenha pedido a bola. Só peça esclarecimento quando o tópico for genuinamente ambíguo ou amplo demais para fazer uma prova coerente ("ciência" é amplo demais; "relatividade restrita — dilatação do tempo e contração do comprimento" é uma prova).

Pesquise e cite — nunca invente

Cada explicação carrega uma citação, e a citação tem que ser real. Esta é a diferença entre uma ferramenta de estudo confiável e uma alucinação com aparência plausível.

Para tópicos técnicos, científicos, médicos, históricos ou em rápida mudança, pesquise na web para fundamentar a explicação e obter uma fonte verificável — um livro-texto com edição e capítulo, um artigo de revisão com DOI, um órgão normativo, um site de referência respeitável. Prefira fontes primárias e autoritárias a blogs. Capture uma URL ou DOI real para que a citação tenha link.

Para tópicos estáveis de conhecimento geral onde você tem alta confiança (aritmética básica, definições bem estabelecidas), é aceitável citar uma referência padrão sem pesquisa ao vivo — mas nomeie uma fonte específica e verificável (por exemplo, "Griffiths, Introduction to Electrodynamics, 4ª ed., §2.3"), nunca um vago "livros-texto" ou um número de página inventado.

Se você não conseguir encontrar uma fonte real para uma afirmação, isso é um sinal de que a afirmação pode ser frágil — reformule a pergunta em torno de algo que você possa referenciar, em vez de inventar uma citação. Falsificar uma citação é pior do que não ter nenhuma.

Escreva as perguntas

Busque uma mistura que realmente exercite a compreensão, não apenas a memorização. Boas provas dependem de perguntas que fazem o aprendiz aplicar uma ideia. Varie o formato:

  • Múltipla escolha é a espinha dorsal — corrigível automaticamente, e as opções erradas são uma oportunidade de ensino. Faça distratores plausíveis: cada resposta errada deve corresponder a um erro ou equívoco comum e específico, de modo que escolhê-la ensine algo ao aprendiz. Evite opções de piada descartáveis e pegadinhas óbvias.
  • Numérica / resposta curta adequa-se a tópicos quantitativos — o aprendiz resolve e confere com a resposta e sua solução detalhada.
  • Aberta / derivação pede que o aprendiz raciocine ou derive, depois revela uma resposta modelo para autoavaliação. Use estas em dificuldades mais altas.

Para cada pergunta escreva:

  1. Um enunciado claro. Use LaTeX para qualquer matemática (veja a seção de formato) — inline \( ... \) ou exibição \[ ... \].
  2. Uma explicação simplificada da resposta correta — o coração da skill. Explique como um bom tutor faria para alguém no nível escolhido: simples, direto, construindo sobre o que sabem. Simplifique a linguagem, não a correção.
  3. Quando quantitativa, uma derivação: uma lista ordenada de etapas desde os primeiros princípios até o resultado, cada etapa uma curta linha de raciocínio mais sua equação. O HTML revela estes blocos um de cada vez para que o aprendiz possa tentar antes de espiar.
  4. Uma ou mais citações, cada uma com um rótulo e (idealmente) uma URL/DOI.

Calibre a profundidade para a dificuldade: no nível Básico você pode pular a derivação e dar uma analogia intuitiva; no nível PhD a derivação é rigorosa e a citação é uma fonte primária.

Construa o HTML interativo

Use o modelo incluído em vez de criar uma página manualmente cada vez — ele já lida com renderização MathJax, verificação de respostas, manutenção de pontuação, progresso, derivações recolhíveis e links de citação, e tem uma aparência limpa. Leia references/html-format.md para o procedimento completo de construção e o esquema exato de dados QUIZ, então preencha o bloco de dados do modelo com suas perguntas. Não reescreva o CSS/JS do modelo do zero; você fornece apenas o conteúdo.

A página final deve permitir que o aprendiz: leia uma pergunta com equações renderizadas corretamente, escolha ou revele uma resposta, receba feedback imediato de certo/errado, expanda a explicação e a derivação passo a passo, siga links de citação e veja uma pontuação contínua com um resumo ao final. Um crachá de dificuldade fica no topo para que saibam o que estão fazendo.

Entrega

Salve a prova finalizada como um único arquivo .html na pasta de saída de skills que o usuário preferir (de acordo com convenções de projeto/memória), nomeie-a descritivamente (quiz-<tópico>-<dificuldade>.html) e apresente-a ao usuário para que possa abri-la diretamente. Mantenha sua mensagem de encerramento curta — a prova fala por si. Ofereça-se para ajustar a dificuldade, adicionar perguntas ou restringir o tópico como um acompanhamento natural.

Sinalização de suposições

Se você precisou tomar uma decisão que afeta a correção — você assumiu uma convenção (sinal, unidades, notação), escolheu um lado de um ponto genuinamente debatido, ou não conseguiu verificar completamente uma fonte — diga isso brevemente ao entregar a prova, para que o usuário possa testá-la. Suposições silenciosas em uma ferramenta de estudo propagam-se para o que alguém aprende.

Habilidades Relacionadas