| name | revisar-disciplina |
| description | Revisão e correção de conteúdo de qualquer disciplina deste repo (Átomo 3.0,
legacy unit-based ou aula-based). Verifica correção técnica/factual, conformidade
estrutural com o template, LaTeX/matemática, decks HTML (sem MathJax), questões,
imagens e material complementar. Use quando pedirem para "revisar", "corrigir",
"validar" ou "conferir" uma unidade, aula, disciplina ou deck de slides.
|
| user-invocable | true |
| argument-hint | [caminho da disciplina/unidade/aula a revisar] |
Revisar / Corrigir Disciplina
Skill de revisão de conteúdo didático em pt-BR. O objetivo é encontrar e corrigir
erros técnicos, quebras de formatação e desvios do template em qualquer
disciplina do repo — exatamente a classe de problemas que o commit de melhorias da
disciplina portos_aeroportos_e_ferrovias tratou (correção de massa do TR-68,
carga por eixo, LaTeX literal fora de $...$, LaTeX em decks sem MathJax, etc.).
A skill não é só validação: ela aponta o problema, propõe a correção e (quando
autorizada) aplica a edição no markdown/HTML. Nunca edita os .docx em
Originais - Átomo 3.0/.
Passo 0 — Identificar o alvo e o layout
A partir do argumento (caminho de disciplina, unidade, aula ou deck), determine o
layout da disciplina — as regras mudam conforme ele:
| Layout | Como reconhecer | Arquivos a revisar |
|---|
| Átomo 3.0 | tem unidade_N/unidade_N.md + questoes_uniN.md + instrumentos_avaliativos/ | unidade_N.md, questoes_uniN.md, slides/aulaN.html, avaliacao_final.md, entrega_trabalho.md |
| Legacy unit-based | tem unidade_N_conteudo.md + unidade_N_i_aula.md + DIRETRIZES_*.json | os .md da unidade + questoes_unidade_N.md |
| Aula-based | tem aulas/aulaN.md + roteiros/ + questoes/ + m_complementar/ | aulaN.md e parceiros + *.svg |
Para os layouts legacy/aula-based, leia primeiro o DIRETRIZES_DISCIPLINA.json /
DIRETRIZES_UNIDADE.json / diretrizes_latex.json / directions.json da disciplina —
eles são a fonte de verdade e podem sobrepor as regras gerais abaixo. Para Átomo 3.0
não há JSON; as regras vêm do CLAUDE.md e dos templates Word em Originais - Átomo 3.0/.
Ignore sempre o scaffolding AIOX (.aiox-core/, .antigravity/, .claude/ dentro
das disciplinas) — não é conteúdo.
Eixos de revisão
Rode os eixos abaixo. Para cada achado, registre: arquivo:linha, categoria,
severidade (🔴 erro factual / quebra de render · 🟡 desvio de template · 🔵 melhoria)
e a correção proposta.
1. Correção técnica / factual (🔴 prioridade máxima)
É o eixo mais importante e o que exige leitura atenta, não regex. Procure por:
- Valores numéricos errados ou improváveis. Confira grandezas de engenharia
contra a realidade brasileira/normas. Exemplos reais do commit:
- massa linear de trilho TR-68 = 67,4 kg/m (não 33,8); a regra "TR-XX ≈ XX kg/m"
vale para a nomenclatura brasileira.
- carga por eixo ferroviária no Brasil = 25 a 32,5 t/eixo (40 t é atípico).
- conferir unidades e ordens de grandeza (largura de pista código 4 ≈ 45 m,
envergadura A380 ≈ 80 m, etc.).
- Afirmações que se contradizem entre markdown, tabela, SVG e deck da mesma aula
(um valor corrigido num arquivo e esquecido em outro). Sempre cheque o mesmo dado
em todos os arquivos da aula (md + slide + svg).
- Referências normativas plausíveis e específicas (ASTM, AREMA, UIC/EN, OACI/ICAO
Anexo, RBAC, ABNT, NBR, DNIT). Quando citar norma, citar o número certo.
- Exemplo numérico: refazer a conta. O resultado bate? As unidades fecham?
Quando tiver dúvida factual e a tarefa permitir, verifique (WebSearch/WebFetch ou
fontes do material complementar) antes de "corrigir" — não troque um número certo por
um errado. Se não puder verificar, marque como 🟡 "checar" em vez de editar.
2. Matemática / LaTeX (🔴 quebra de render)
Regras do build_pdfs.py + convenções de diretrizes_latex.json:
- Inline com
$…$; bloco com $ sozinho na linha. Nunca cercar matemática em
code fences (```).
- Bug clássico — LaTeX literal fora de
$...$: comandos como \,, \mathrm{},
\geq, \leq, ^{\circ}, \times, \approx, frações 7%/300\,\mathrm{m}
aparecendo como texto cru no corpo. Ou se embrulha em $...$, ou se converte
para texto plano ("7% por 300 m"). Busque por \mathrm, \,, \geq, \circ,
\times, \approx, \leq fora de $...$.
- Unidades:
\mathrm{} + espaço fino \, (ex.: 15\,\mathrm{kN}, 1{,}435\,\mathrm{m}).
- Decimal com vírgula via
{,} no LaTeX (ex.: 0{,}5, não 0.5).
$...$ desbalanceado (número ímpar de $ numa linha/parágrafo) → render quebra.
3. Decks HTML — slides (🔴 os decks NÃO têm MathJax)
Este é o eixo mais traiçoeiro. Os slides/aulaN.html são single-file e não
renderizam LaTeX. Logo:
- Nenhum comando LaTeX pode aparecer no HTML do slide.
\mathrm, \,, m^2,
^{\circ}, \geq, $...$ viram lixo na tela. Tudo deve estar em unicode/HTML:
m², °C, ≥, ≤, ×, →, ≈, ³, frações com ½/⁄ ou texto. (O commit
converteu ~47 desses spans na U3.) Busque \ e $ dentro dos .html de slides/.
- Os valores técnicos do slide devem bater com o markdown corrigido da mesma aula.
- Estrutura UniFECAF: capa com mosaicos, slide Audiodescrição após a capa,
"Sobre o professor", triângulos grandes e esparsos (não o padrão pequeno repetido),
cartão azul + título verde-claro. Variáveis
--azul-fecaf #002057 e --amarelo #F0CE29
no :root. Logo institucional carrega de URL hasheada — se 404, atualizar href.
4. Estrutura / conformidade com o template (🟡)
Por aula (todos os layouts): 700–1200 palavras, 6–10 subseções, 1–3 imagens com
alt descritivo, ≥1 exemplo numérico, 1 atividade prática, 3–5 pontos-chave, 2–4 links
complementares.
Átomo 3.0 — por unidade: 4 aulas inline (videoaulas 1–16: U1=1–4, U2=5–8, U3=9–12,
U4=13–16), roteiro por videoaula, quiz não avaliativo (2 questões), AAI (1 dissertativa
- resposta esperada), material complementar (4 seções fixas). U1 abre com vídeo
introdutório; Aula 3 tem "Pausa para Reflexão"/Desafio; Aula 4 das U1–U3 prevê a próxima
unidade; Aula 4 da U4 encerra a disciplina.
Material complementar — 4 seções fixas: Direto da Fonte (BV/Brightspace),
Para Mergulhar (filme/série/livro/blog), Podcast (tem de ser YouTube),
Artigo científico (DOI + ABNT).
Legacy/aula-based: validar contra o validacao_checklist do DIRETRIZES_*.json.
5. Questões (🟡/🔴)
- Átomo 3.0 (
questoes_uniN.md): 20 questões — 10 asserção-razão + 10
interpretação, 5 alternativas (a–e), correta prefixada por *, ## Feedbacks ao final.
- Avaliação final Átomo 3.0: 40 questões — 15 AR + 15 interpretação + 10 discursivas
(discursivas ao final).
- Legacy (
questoes_unidade_N.md): 20 MC, 5 alternativas, * na correta, feedbacks;
distribuição balanceada do gabarito (4× cada letra a–e num conjunto de 20 — ver
how_to_create_questions.json).
- Verificar: exatamente uma alternativa marcada com
* por questão; nº de feedbacks =
nº de questões; nenhuma alternativa duplicada; enunciado coerente com o gabarito.
6. Imagens / assets (🟡)
- Formato
; alt descritivo (não "imagem"/"figura").
- Preferir Wikimedia Commons; assets locais em
<unidade>/assets/ (e assets/downloads/).
- SVGs cotados devem ter o desenho coerente com o texto (mesma grandeza/valor) e alt
que descreva o que está cotado.
- Links devem resolver; rodar
normalize_images.py antes do build se houver links novos.
Saída
- Relatório agrupado por eixo e severidade, cada item como
arquivo:linha — [severidade] categoria: problema → correção.
- Se o usuário pediu correção (não só revisão), aplique os 🔴 e 🟡 de baixo risco
via Edit, mantendo o estilo do texto vizinho; deixe os 🔵 e os factuais incertos como
sugestão para o usuário aprovar.
- Não rode build nem commit a menos que pedido. Se editar, lembre que Átomo 3.0 não
tem tooling (markdown é o entregável) e que decks exportam PDF via Chrome Print.
Commit (só se solicitado)
Conventional Commits com escopo de commit-guidelines.json. Escopos válidos: base,
unidade_1–unidade_4, instrumentos_avaliativos, estrutura_pontes, industria_4_0,
sistemas_informacao (use o escopo da disciplina/unidade). Encerrar a mensagem com a
linha Co-Authored-By exigida pelo harness.
