Communitygithub.com

Paper Format Agent

Formatador de documentos acadêmicos DOCX com proteção de integridade de conteúdo: garante que apenas a formatação seja alterada, nunca o texto. Também instalável como skill de agente.

O que é Paper Format Agent?

O **Paper Format Agent** é uma skill para formatação local de documentos acadêmicos, focada em arquivos `.docx`. Ela oferece uma salvaguarda inovadora baseada em impressão digital de conteúdo (content fingerprint), que verifica se o texto original não foi alterado durante o processo de formatação. A tool suporta a especificação de regras de formatação em arquivos `.docx`, `.doc` ou `.txt`, possibilitando a adequação a normas de diferentes periódicos ou universidades. A skill prioriza a privacidade: por padrão, não envia documentos para serviços externos e trata todo conteúdo acadêmico como sensível. O fluxo de trabalho padrão envolve a execução de um CLI que gera artefatos como o documento formatado (`formatted_paper_v3.docx`), regras extraídas e relatórios de formatação. O usuário pode inspecionar relatórios como `format_report.json` para verificar se o conteúdo foi alterado (indicador `content_changed: false`) e se a proteção de conteúdo foi aplicada. Além disso, a skill é extensível, incentivando contribuições como novos testes sintéticos para regras de formatação, melhorias em extratores de regras e refinamentos na documentação do workflow.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add zxyasfas/paper_format_agent

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Paper Format Agent faz?

Use esta skill para trabalhos de formatação de documentos acadêmicos locais. Ela é projetada para artigos em .docx e uma especificação de formatação separada em .docx, .doc ou .txt.

Padrões de Segurança

  • Nunca envie artigos privados ou guias de formatação para serviços externos, a menos que o usuário solicite explicitamente.
  • Trate trabalhos de alunos, manuscritos, comentários de revisores e modelos escolares como dados confidenciais.
  • Não altere o conteúdo acadêmico, a menos que o usuário opte explicitamente. O padrão são apenas alterações de formatação.
  • Mantenha relatórios e documentos gerados em um diretório de saída fornecido pelo usuário.

Fluxo de Trabalho Padrão

  1. Confirme os arquivos de entrada:
    • --format-file: guia de formatação ou texto do modelo.
    • --paper-file: artigo fonte, atualmente .docx.
    • --out-dir: diretório de saída para relatórios e documentos gerados.
  2. Execute a CLI no modo apenas formatação:
python -m paper_format_agent.cli \
  --format-file "format_guide.docx" \
  --paper-file "paper.docx" \
  --out-dir "./output" \
  --engine auto \
  --strict-required-sections
  1. Inspecione os artefatos gerados:
    • formatted_paper_v3.docx: documento corrigido.
    • format_rules.json: regras extraídas.
    • format_report.json: pontuação e verificações legíveis por máquina.
    • format_report.html: relatório legível por humanos.
    • modify_log.json: operações de formatação.
    • engine_report.json: resultado do motor de pós-processamento.
  2. Verifique os campos de proteção de conteúdo em format_report.json:
    • content_changed normalmente deve ser false.
    • content_guard_enforced normalmente deve ser true.
  3. Se uma regra estiver errada, atualize a lógica de extração ou pontuação de regras e adicione um caso de teste mínimo.

Validação

Execute estes comandos antes de entregar o trabalho:

python tools/validate_skill.py
python -m unittest discover -s tests -p "test_*.py"
python tools/compile_check.py
python tools/release_audit.py

Ao Adicionar Suporte para Modelos

  • Adicione o menor texto de regra representativo necessário para reproduzir o comportamento.
  • Prefira extração de regras determinística em vez de interpretação apenas via LLM.
  • Adicione testes para margens, tamanho da fonte, espaçamento entre linhas, seções obrigatórias, cabeçalhos, legendas ou referências.
  • Não commite documentos reais de alunos. Use texto sintético ou fixtures anonimizadas.

Ao Revisar a Saída

Leia format_report.json primeiro, depois inspecione format_report.html se o usuário precisar de um resumo legível. Priorize problemas nesta ordem:

  1. Conteúdo alterado inesperadamente.
  2. Seções obrigatórias ou cabeçalhos mal classificados.
  3. Configuração de página, margens, fontes ou espaçamento entre linhas incorretos.
  4. Legendas, referências, tabelas ou numeração com aparência incorreta.
  5. Redação do relatório ou explicação da pontuação pouco clara.

Tarefas Amigáveis para Contribuições

Bons primeiros PRs geralmente se encaixam em uma destas categorias:

  • Adicionar um teste sintético para uma regra de formatação de escola, periódico ou conferência.
  • Melhorar um extrator de regras com uma regex ou parser de escopo restrito.
  • Melhorar a clareza do relatório sem alterar a semântica da pontuação.
  • Adicionar um caso de regressão a docs/regression_manifest.sample.json.
  • Melhorar este workflow da skill ou os metadados de agents/openai.yaml.

Habilidades Relacionadas