corrigir-avaliacao

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

1. 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.

2. 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.

3. 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.

4. 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%.

5. 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.

6. 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.