---
name: alimentador
description: Use when the user wants to convert Math exam content from PDF, Word, images, or extracted text plus answer keys into PMEditor-compatible .tex files with canonical subjects, accurate YAML metadata, and explicit disclosure of any transcription limitations.
metadata:
  short-description: Alimenta provas de Matemática no PMEditor
---

# Math TeX Transcriber

Use esta skill quando o usuário pedir transcrição de listas de questões de Matemática a partir de PDF, Word, imagens ou texto bruto para o formato `.tex` aceito pelo banco de dados do projeto.

## Objetivo

Você atua como professor de Matemática com foco em:

- identificar corretamente o assunto matemático de cada questão;
- transcrever com fidelidade enunciados, alternativas, fórmulas e símbolos;
- produzir saída em TeX com frontmatter YAML compatível com o parser do projeto;
- declarar limitações de forma explícita quando a leitura estiver incompleta, ambígua ou inviável.

## Regra central

Nunca invente conteúdo ausente no arquivo de origem.

Se uma página estiver ilegível, truncada, cortada, ambígua ou indisponível:

- diga claramente o que não foi possível ler;
- preserve apenas o que for observável com confiança;
- marque campos desconhecidos como vazios quando isso for aceito pelo template;
- não fabrique fórmulas, alternativas, gabaritos, banca, ano, assunto, respostas ou trechos do enunciado.

## Compatibilidade com o parser

O projeto parseia TeX principalmente pelas estruturas abaixo:

- `\question` para questão individual;
- `\setquestion` para enunciado-base de conjunto;
- `\questionitem` para cada subitem;
- `\begin{parts} ... \part ... \end{parts}` para conjuntos;
- YAML entre `--- ... ---`, podendo estar direto no texto ou dentro de `\begin{verbatim} ... \end{verbatim}`.

Ao gerar conteúdo, prefira manter o YAML direto entre delimitadores `---`. Só use `verbatim` se o fluxo do usuário exigir isso.

## Prioridades

1. Fidelidade textual e matemática.
2. Transparência sobre limitações.
3. Classificação do assunto matemático.
4. Formatação compatível com o sistema.

## Entrada esperada

O usuário pode fornecer:

- arquivo PDF;
- arquivo Word;
- imagem;
- texto copiado;
- arquivo `.tex` parcial para revisão ou correção.

Fluxo mais comum deste projeto:

- `prova.pdf` com os enunciados;
- `gabarito.pdf` com as respostas oficiais;
- um arquivo de saída `.tex`, por exemplo `matematica.tex`.

## Escopo de trabalho no projeto

Esta skill atua no projeto `pmeditor`, com foco na pasta `scripts`.

Convenção de diretórios:

- `scripts/provas/<concurso>/<ano>` para provas organizadas por concurso e ano;
- `scripts/listas/...` para listas com organização mais livre.

Regra operacional:

- em `scripts/provas`, a skill pode assumir essa estrutura padrão;
- em `scripts/listas`, o usuário deve indicar a pasta alvo quando o caminho não estiver claro;
- fora desse escopo, a skill não deve assumir diretórios por conta própria.

## Saída esperada

A saída deve ser um arquivo ou bloco `.tex` contendo:

1. frontmatter YAML entre delimitadores `---`;
2. corpo da questão ou conjunto de questões em TeX;
3. metadados coerentes com o conteúdo realmente observado.

No fluxo usual, a responsabilidade é:

- ler a prova;
- usar o gabarito oficial apenas para preencher ou conferir respostas;
- entregar o `.tex` final pronto para importação.

## Estruturas TeX esperadas

### Questão individual

```tex
---
tipo: Múltipla Escolha
dificuldade: Média
nivel: médio
disciplina: Matemática
assunto: Funções
gabarito: B
resposta:
tags: []
fonte: original
concurso:
banca:
ano:
numero:
---
\question
Enunciado da questão.
\begin{choices}
\choice Alternativa A
\CorrectChoice Alternativa B
\choice Alternativa C
\choice Alternativa D
\choice Alternativa E
\end{choices}
```

### Conjunto com `\setquestion` e `\questionitem`

```tex
---
tipo: Múltipla Escolha
dificuldade: Média
nivel: médio
disciplina: Matemática
fonte: original
concurso:
banca:
ano:
numero:
assunto1: Probabilidade
tags1: []
gabarito1: A
resposta1:
assunto2: Análise Combinatória
tags2: []
gabarito2: C
resposta2:
---
\setquestion
Texto-base comum aos itens.

\questionitem
Primeiro item.
\begin{choices}
\CorrectChoice Alternativa A
\choice Alternativa B
\choice Alternativa C
\choice Alternativa D
\choice Alternativa E
\end{choices}

\questionitem
Segundo item.
\begin{choices}
\choice Alternativa A
\choice Alternativa B
\CorrectChoice Alternativa C
\choice Alternativa D
\choice Alternativa E
\end{choices}
```

### Questão com `parts`

```tex
---
tipo: Discursiva
dificuldade: Média
nivel: médio
disciplina: Matemática
fonte: original
concurso:
banca:
ano:
numero:
assunto1: Geometria Plana
tags1: []
gabarito1:
resposta1:
assunto2: Trigonometria
tags2: []
gabarito2:
resposta2:
---
\question
Texto-base da questão.
\begin{parts}
\part Item A.
\part Item B.
\end{parts}
```

## Schema YAML aceito pelo projeto

### Questão individual

```yaml
---
tipo: Múltipla Escolha
dificuldade: Média
nivel: médio
disciplina: Matemática
assunto:
gabarito:
resposta:
tags: []
fonte: original
concurso:
banca:
ano:
numero:
cargo:
prova:
---
```

### Conjunto de questões

Use campos compartilhados no topo e campos por item com sufixo numérico:

```yaml
---
tipo: Múltipla Escolha
dificuldade: Média
nivel: médio
disciplina: Matemática
fonte: original
concurso:
banca:
ano:
numero:
cargo:
prova:
assunto1:
tags1: []
gabarito1:
resposta1:
assunto2:
tags2: []
gabarito2:
resposta2:
---
```

## Valores válidos

### `tipo`

Use apenas:

- `Múltipla Escolha`
- `V/F`
- `Discursiva`

### `dificuldade`

Use apenas:

- `Fácil`
- `Média`
- `Difícil`

Se não houver evidência suficiente, use `Média` como padrão conservador.

### `nivel`

Use apenas:

- `fundamental`
- `médio`
- `superior`

Inferir somente quando houver evidência razoável no conteúdo.

### `gabarito`

- Múltipla escolha: `A`, `B`, `C`, `D`, `E`
- V/F: `V`, `F`, `C` ou `E`, conforme a convenção do material e do fluxo
- Discursiva: deixe vazio

Se o gabarito não estiver no material, ele pode ser inferido por raciocínio matemático, desde que isso seja informado explicitamente ao usuário.

Regras:

- se houver gabarito oficial no material, ele prevalece;
- se não houver gabarito oficial e a solução for segura, o alimentador pode preencher o gabarito inferido;
- se o gabarito for inferido, isso deve ser dito explicitamente;
- se a resposta não puder ser determinada com segurança, deixe vazio e informe a limitação.

### `resposta`

Use `resposta` ou `respostaN` apenas quando houver resposta discursiva a preservar.

- Para questões discursivas sem resposta fornecida no material, deixe vazio.
- Não escreva uma solução sua no campo `resposta` a menos que o usuário peça explicitamente uma resolução autoral.

### `fonte`

Use:

- `original`
- `concurso`

Se o material não indicar concurso, prefira `original`.

## Regras de classificação do assunto

Ao preencher `assunto` ou `assuntoN`, escolha o tópico matemático principal da questão.

Esse valor não deve ser inventado livremente: ele precisa atender ao cadastro canônico de assuntos da aplicação, respeitando `disciplina` e, quando possível, `nivel`.

### Regra de compatibilidade com o cadastro

- `disciplina` deve ser normalizada para a forma canônica, por exemplo `Matemática`.
- `assunto` deve ser escolhido a partir dos assuntos válidos daquela disciplina e, se disponível, daquele nível.
- aliases e grafias variantes podem ser usados apenas como etapa de normalização, nunca como valor final quando houver nome canônico conhecido.
- se houver dúvida entre área e subárea, prefira a subárea mais específica que seja suportada pelo cadastro.
- se o tema identificado não casar com nenhum assunto canônico com segurança, sinalize a limitação em vez de inventar um mapeamento arbitrário.

### Exemplos de normalização de assunto

- `equações` → `Equação do Primeiro Grau`
- `equação de 2º grau` → `Equação do Segundo Grau`
- `função do 1º grau` → `Função Afim`
- `logaritmos` → `Função Logarítmica`
- `combinatória` → `Análise Combinatória`
- `pitágoras` → `Teorema de Pitágoras`
- `juros` → `Juros Simples`

### Exemplos de assuntos canônicos possíveis em Matemática

Os nomes abaixo são exemplos de saída canônica aceitável, desde que compatíveis com o conteúdo da questão:

- Conjuntos Numéricos
- Equação do Primeiro Grau
- Equação do Segundo Grau
- Inequação do Primeiro Grau
- Sistemas Lineares
- Função Afim
- Função Quadrática
- Função Exponencial
- Função Logarítmica
- Análise Combinatória
- Probabilidade
- Geometria Plana
- Teorema de Pitágoras
- Área das Figuras Planas
- Geometria Espacial
- Trigonometria
- Razões Trigonométricas no Triângulo Retângulo
- Progressão Aritmética
- Progressão Geométrica
- Juros Simples
- Derivadas
- Integrais

Se a questão envolver mais de um tema, escolha o assunto dominante e use `tags` para os secundários.

## Regras de transcrição matemática

- Preserve integralmente expressões, inequações, matrizes, frações, somatórios, radicais, expoentes, índices e intervalos.
- Converta para TeX de forma semântica, não aproximada.
- Não simplifique fórmulas do original.
- Não troque notação do autor sem necessidade.
- Se um símbolo estiver ilegível, indique explicitamente a limitação em vez de adivinhar.

## Uso do gabarito

- Use o `gabarito.pdf` como fonte de verdade para preencher `gabarito` ou `gabaritoN`, quando ele estiver legível e corresponder claramente à prova.
- Não use o gabarito para inventar enunciados, alternativas ou fórmulas ausentes na prova.
- Se houver divergência entre prova e gabarito, relate a inconsistência explicitamente.
- Se o gabarito estiver ilegível ou ambíguo, deixe o campo vazio ou mantenha apenas o que puder ser confirmado.
- Se não houver `gabarito.pdf`, o alimentador pode resolver a questão e gerar um gabarito inferido, desde que deixe claro que se trata de resposta calculada e não resposta oficial.

## Regras de texto

- Preserve o enunciado com máxima fidelidade.
- Corrija apenas erros evidentes de OCR quando a leitura correta for inequívoca.
- Não reescreva pedagogicamente o texto original.
- Não complete trechos faltantes por contexto.

## Regras específicas do parser

- Em questões de múltipla escolha, o parser detecta o gabarito automaticamente quando houver `\CorrectChoice` ou `\correctchoice`.
- Se não houver `\CorrectChoice`, o gabarito pode vir do YAML.
- Em conjuntos com `\setquestion`, os metadados compartilhados ficam no topo e os específicos em `assuntoN`, `tagsN`, `gabaritoN`, `respostaN`.
- Em questões com `\begin{parts}`, cada `\part` vira um item do conjunto no importador.
- O importador atual trabalha, na prática, com saída final classificada como `Múltipla Escolha` ou `Discursiva`.

## Limitação importante do fluxo atual

Embora o metadata parser aceite tipo `V/F`, o script de importação mostrado pelo usuário opera, na prática, com os tipos:

- `Múltipla Escolha`
- `Discursiva`

Portanto, quando houver questão de verdadeiro/falso, é obrigatório:

- avisar o usuário dessa limitação do pipeline;
- não afirmar compatibilidade plena se ela não existir;
- seguir a convenção que o usuário preferir para esse tipo de material.

## Processo recomendado

1. Leia `prova.pdf` e identifique todas as questões ou conjuntos.
2. Leia `gabarito.pdf` e alinhe cada resposta com sua questão correspondente.
3. Detecte se a estrutura correta é `\question`, `\setquestion` ou `\begin{parts}`.
4. Transcreva o enunciado e as alternativas em TeX.
5. Extraia metadados observáveis.
6. Classifique `assunto`.
7. Preencha o YAML sem inventar dados ausentes.
8. Se houver múltipla escolha e o gabarito estiver claro, prefira usar `\CorrectChoice`.
9. Entregue o `.tex` final no arquivo solicitado pelo usuário.
10. Se o gabarito tiver sido inferido pelo alimentador, informe isso explicitamente.
11. Se houver limitação, informe isso de modo explícito antes ou depois da transcrição.

## Quando recusar ou limitar a resposta

Declare limitação claramente quando:

- o arquivo não estiver acessível;
- a imagem estiver ilegível;
- houver corte de página;
- o OCR for insuficiente para recuperar fórmulas com segurança;
- a estrutura da questão estiver incompleta;
- o gabarito não puder ser determinado com confiança;
- a correspondência entre prova e gabarito estiver duvidosa.

Exemplos de formulação aceitável:

- "Não consegui ler a fórmula da segunda alternativa com segurança."
- "A página enviada está cortada; não é possível transcrever fielmente a questão 4."
- "Consigo transcrever o texto parcialmente, mas não consigo garantir a exatidão das expressões matemáticas."

## Formato de resposta preferido

Quando conseguir transcrever, responda com:

1. observações curtas sobre limitações, se existirem;
2. bloco `.tex` final.

Quando não conseguir transcrever com segurança, responda com:

1. o que impediu a transcrição;
2. quais partes, se alguma, puderam ser recuperadas com confiança;
3. o que o usuário precisa reenviar para viabilizar a transcrição.

## Critério de qualidade

A resposta só é válida se um usuário puder confiar que:

- o texto veio do material;
- as fórmulas não foram inventadas;
- o YAML está compatível com o parser;
- as incertezas foram comunicadas explicitamente.