steffen74/para-quiz

Para quiz

Escreva e publique o quiz de uma unidade. Leia COURSE-CANVAS.md, PLAN.md, RESOURCES.md, DECISIONS.md, a seção ## Criação de curso agente de AGENTS.md e o material da unidade anterior (os vídeos e tarefas que o quiz cobre). Carregue assumed-knowledge.

1. Ferramenta e fonte

AGENTS.md deve ter uma linha - Quizzes: <arquivo fonte>, ferramenta <nome>, conector <nome|nenhum>, definida em /setup-course. Se estiver faltando, pergunte uma vez, recomende e escreva:

• Fonte: um arquivo no repositório privado do curso contém cada pergunta com opções, resposta correta e explicação (um CSV com as colunas session, type, question, option_a, option_b, option_c[, option_d], correct, explanation, ou Markdown que o espelhe). A ferramenta de quiz é uma cópia, nunca a fonte.
• Ferramenta: escolhida uma vez por curso, por exemplo Microsoft Forms ou Formbricks. A pontuação é opcional; a maioria das verificações de vídeo precisa apenas da distribuição de respostas para discussão em aula.

2. Escreva as perguntas

Elabore de três a cinco perguntas para a unidade, cada uma com:

• uma pergunta sobre algo que os alunos encontraram antes da sessão: os vídeos e tarefas da unidade anterior. Nunca pergunte sobre conteúdo que a própria sessão introduz.
• três ou quatro opções, uma correta; as opções erradas são os equívocos que os alunos realmente têm (de SIGNALS.md, quando disponível), não perguntas capciosas.
• uma explicação de uma ou duas frases, para o instrutor usar em aula.
• um tipo: video, task ou skill, com sua fonte.

Baseie as perguntas no que o material realmente diz. Quando uma pergunta se basear em um vídeo que você não pode ler, marque-a apenas pelo título na explicação; o instrutor a verifica em relação ao vídeo.

Mostre as perguntas e aguarde o instrutor. Em seguida, escreva-as na fonte.

3. Criar na ferramenta

• Conector conectado para a ferramenta: mostre o quiz como será criado, aguarde um sim, crie-o como rascunho e registre seu link de compartilhamento. Construa a solicitação a partir da fonte de quiz no esquema próprio do conector (leia suas descrições de ferramenta; esquemas mudam entre versões) e use sua ferramenta de validação primeiro, quando houver uma.
  • Formbricks tem um servidor MCP oficial com login OAuth (https://app.formbricks.com/api/mcp, ou https://<dominio>/api/mcp quando auto-hospedado; as ferramentas incluem list_workspaces, validate_survey, create_survey). Se o curso usar Formbricks e ele não estiver conectado, forneça ao instrutor o comando para adicioná-lo ao seu agente (no Claude Code: claude mcp add --transport http formbricks https://app.formbricks.com/api/mcp e faça login via /mcp); não altere a configuração do agente por conta própria.
  • Microsoft Forms não possui API para criar quizzes e nenhum conector oficial; use a exportação abaixo.
• Sem conector: exporte com scripts/export_quiz.py a partir da fonte CSV:
  • Formbricks: --format formbricks escreve um corpo de pesquisa para a API de Gerenciamento e imprime o comando curl. O instrutor o executa com sua própria chave de API a partir de uma variável de ambiente; nunca peça a chave ou a escreva em um arquivo.
  • Microsoft Forms: --format forms escreve um .docx para Quick Import e um gabarito de respostas. O Quick Import não aceita respostas corretas; o instrutor as marca a partir do gabarito (necessário apenas quando a pontuação é usada).
  • Outra ferramenta: escreva o formato de importação mais próximo que ela aceitar, ou uma lista simples para colar.

Respostas e explicações nunca aparecem em um arquivo voltado para os participantes ou em um local público.

4. Entregar

Registre o link do quiz em RESOURCES.md para a unidade (coluna Quiz). Os slides mostram o link (e um código QR, quando o formato do slide permitir), não as perguntas; /to-slides o obtém de RESOURCES.md.

Concluído quando as perguntas estão na fonte, o quiz existe na ferramenta como rascunho ou um arquivo de importação está pronto com instruções, e seu link ou status está em RESOURCES.md.