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
- 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.
- 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
- 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.
- Verifique os campos de proteção de conteúdo em
format_report.json:content_changednormalmente deve serfalse.content_guard_enforcednormalmente deve sertrue.
- 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:
- Conteúdo alterado inesperadamente.
- Seções obrigatórias ou cabeçalhos mal classificados.
- Configuração de página, margens, fontes ou espaçamento entre linhas incorretos.
- Legendas, referências, tabelas ou numeração com aparência incorreta.
- 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.