| name | corrigir-avaliacao |
| description | Corrige a entrega de uma avaliação de curso — notas por área a partir da rubrica da metodologia, nota final por média ponderada e comentários curtos, calibrando a régua de exigência pelo nível da turma. |
| disable-model-invocation | true |
| argument-hint | qual avaliação e onde está a entrega (ex.: Avaliação 1, github.com/.../pull/1) |
Corrigir avaliação
Corrige a entrega de uma avaliação contra a rubrica do curso e devolve, no chat: nota por área, nota final ponderada e comentários curtos justificando cada nota.
Os insumos descrevem um curso qualquer — não presuma o conteúdo de um curso específico. Toda a rubrica vem da metodologia que o professor fornecer.
Insumos (o professor fornece)
- Planejamento das aulas — o que foi ensinado e quando; mapeia o conteúdo que a avaliação cobre. (Ex.: página Notion "… Proposta de Organização do Conteúdo".)
- Metodologia avaliativa — a rubrica: para cada avaliação, seus Critérios de avaliação. (Ex.: página Notion "… Metodologia Avaliativa do Curso".)
- Anamnese da turma — perfil e nível da turma por tema. (Ex.: página Notion "… Acompanhamento dos Alunos".)
- Qual avaliação corrigir (ex.: "Avaliação 1").
- Onde está a entrega — em geral um Pull Request no fork do aluno (ex.: github.com/.../pull/1).
Acesso: páginas Notion pela ferramenta de fetch do Notion; PRs por gh pr view <n> --repo <owner/repo> --json title,body,files,commits e o diff por gh pr diff <n> --repo <owner/repo>.
Escala de notas: 0 a 10, uma casa decimal.
Passos
-
Reunir os insumos. Junte os três documentos, o nome da avaliação e o local da entrega. Use o que veio na invocação; peça só o que faltar. Pronto quando: os três documentos foram lidos, a avaliação está nomeada e a entrega está acessível.
-
Extrair a rubrica. Na metodologia, leia os Critérios de avaliação da avaliação nomeada — cada critério é uma área. Confirme no planejamento qual conteúdo essa avaliação cobre, para avaliar só o que foi pedido. Pronto quando: existe uma lista de áreas, cada uma com o que exige.
-
Definir a régua da turma. Na anamnese, leia o nível da turma nos temas que esta avaliação cobre. Fixe a régua de exigência: turma iniciante → régua mais branda; turma experiente → régua mais severa. A régua é única e vale para todos os alunos da turma — nunca por aluno. Declare a régua em uma frase, ancorada no nível da turma. Pronto quando: a régua está declarada e ancorada no nível da turma.
-
Definir os pesos. Cada área precisa de um peso. Use os pesos que o professor informar (ou que a metodologia trouxer); se nenhum foi dado, pergunte ao professor o peso de cada área. Pronto quando: toda área tem peso e os pesos somam 100%.
-
Analisar a entrega. Leia a entrega de verdade — descrição do PR, commits e o diff completo. Avalie cada área contra seu critério, aplicando a régua. Dê a cada área uma nota 0–10 com justificativa curta ancorada em evidência concreta (arquivo, função, trecho). Pronto quando: toda área tem nota e justificativa apontando evidência específica da entrega.
-
Apresentar o resultado no chat. Monte o relatório: a régua usada; uma tabela com área, peso, nota e comentário curto; a nota final = média ponderada das áreas; e um comentário curto da nota final, explicando como áreas, pesos e régua a produziram. Pronto quando: o relatório traz nota por área (com comentário), a nota final ponderada e o comentário final.
