BorisW269/skills

Polidor de Artigos

Escopo e Referências

Use este skill para polimento acadêmico seguro em TeX (inglês), tradução, revisão, verificação fonte-para-saída, revisão de terminologia ou notação, revisão de consistência numérica e normalização de notação explicitamente autorizada.

Para artigos completos, seções longas, verificação, auditorias de consistência, normalização ou trabalho estrito de guia de estilo, leia references/tex_safe_polishing.md antes de agir. Leia references/tex_safe_polishing_zh.md quando uma orientação de fluxo de trabalho voltada para chinês for materialmente útil; não carregue ambos apenas para duplicar contexto. Para um polimento local curto, use as regras principais abaixo e consulte uma referência apenas quando necessário.

Não use este skill como ferramenta principal para:

• auditorias de novidade, defensabilidade de contribuição, linha de base perigosa ou ataque de revisor; use idea-novelty-auditor se disponível;
• revisão de literatura, enquadramento de lacunas, seleção de referências ou atribuição de papel de citação; use problem-driven-literature-review se disponível;
• redesenho amplo de enredo, estrutura de introdução ou experimento-para-alegação; use paper-argument-reconstructor se disponível.

Quando uma solicitação combinar essas tarefas com polimento, complete a tarefa de raciocínio upstream primeiro e use este skill apenas para a passagem final de linguagem fiel e consistência.

Seleção de Modo e Precedência

Siga a ação explícita solicitada pelo usuário antes de considerar quem produziu a entrada. A proveniência sozinha nunca substitui uma solicitação explícita para polir, auditar, verificar ou normalizar. Se mais de uma ação for solicitada, mantenha seus artefatos e relatórios separados, a menos que o usuário peça uma entrega combinada.

Regras de saída específicas de modo têm precedência sobre regras de saída baseadas no comprimento do documento. Em particular, uma verificação de manuscrito completo ou auditoria apenas de consistência permanece apenas relatório.

Se o usuário solicitar normalização de notação e polimento de prosa, execute e aprove a normalização primeiro, trate o TeX normalizado como a nova linha de base e, em seguida, faça o polimento contra essa linha de base. Não tente validar uma mudança combinada de prosa e símbolo como uma comparação de normalização.

Modo de Polimento Padrão

Polir ou traduzir o texto fornecido, preservando cada elemento protegido. Para um manuscrito completo, execute também auditorias de consistência terminológica, notacional e numérica interna à fonte e relate problemas em nível de fonte sem corrigi-los silenciosamente.

Modo de Verificação

Use o modo de verificação quando o usuário pedir para comparar ou verificar a qualidade de um candidato contra um original.

• Exija tanto o original quanto o candidato para cada julgamento comparativo sobre TeX, matemática, números, unidades, sinais, citações, significado técnico ou força de alegação.
• Se o original não estiver disponível, inspecione apenas as propriedades intrínsecas do candidato e marque cada verificação comparativa de fonte como NÃO AVALIADO; nunca infira preservação apenas do candidato.
• Nunca reescreva ou repare o candidato no modo de verificação, incluindo violações de regras rígidas. Relate cada desvio e sua localização. Aplique correções apenas em uma etapa ou modo de edição separado e explicitamente solicitado.
• Separe os desvios introduzidos pelo candidato de conflitos de terminologia, notação ou numéricos já presentes na fonte.

Modo de Auditoria de Consistência

Quando o usuário pedir apenas por consistência terminológica, de variável, símbolo, notação ou numérica, não reescreva o manuscrito. Audite o escopo disponível e relate descobertas TERM-*, SYM-* e NUM-* conforme aplicável. Mantenha o texto fonte, símbolos, valores, unidades e sinais inalterados.

Modo de Normalização de Notação Aprovada

Use este modo apenas quando o usuário solicitar explicitamente normalização e tiver aprovado um mapeamento exato de símbolos. Um mapeamento aprovado deve identificar a entidade matemática, símbolos antigos e novos, escopo ou locais afetados e quaisquer aliases ou exclusões intencionais.

• Aplique apenas as substituições de símbolos aprovadas. Não reinterprete definições nem escolha um símbolo canônico em nome do usuário.
• Registre cada substituição aplicada como ALTERAÇÃO AUTORIZADA; trate toda diferença matemática, estrutural, textual ou numérica não mapeada como um erro.
• Mantenha todos os números, unidades, porcentagens, dimensões, tamanhos de amostra, ordenação de tokens numéricos e sinais positivos, negativos ou de mais-menos inalterados.
• Se um símbolo afetado ocorrer dentro de um ativo de figura não disponível ou não editável, ambiente personalizado, arquivo gerado ou expansão de macro não resolvida, relate o local não resolvido e não reivindique normalização completa.
• Valide o resultado normalizado contra o mapeamento aprovado. Se a comparação ciente do mapeamento não estiver disponível, obtenha aprovação do TeX normalizado como uma nova linha de base aprovada pelo autor e, em seguida, use comparação estrita contra essa linha de base para todo polimento subsequente.

Não use --allow-additions para autorizar mudanças de símbolos. Não modifique um número, unidade ou sinal numérico em nenhum modo do polidor de artigos, mesmo após relatar um conflito NUM-*. Peça ao usuário para corrigir a fonte fora deste skill e fornecer o TeX corrigido como uma nova linha de base aprovada pelo autor; nunca infira ou aplique um valor de substituição.

Protocolo de Cobertura e Resultado Compartilhado

Relate cobertura e resultado separadamente para cada auditoria de consistência terminológica, notacional e numérica.

• Cobertura: MANUSCRITO COMPLETO significa que a porta de completude abaixo passou.
• Cobertura: PARCIAL significa que apenas o escopo local ou resolvível declarado foi auditado.
• Resultado: APROVADO significa que nenhum conflito ou ambiguidade não resolvida foi encontrada dentro do escopo avaliado.
• Resultado: PROBLEMA RELATADO significa que pelo menos uma inconsistência clara foi encontrada e nenhuma descoberta ainda requer uma decisão do autor.
• Resultado: DECISÃO DO AUTOR REQUERIDA significa que pelo menos uma descoberta plausível não pode ser resolvida apenas com o manuscrito. Problemas confirmados permanecem individualmente rotulados como PROBLEMA RELATADO.
• Resultado: NÃO AVALIADO significa que essa auditoria ou comparação não pôde ser realizada. Não o use meramente porque a cobertura é parcial.

Atribua identificadores de descoberta determinísticos em ordem de arquivo e fonte relativa à raiz: TERM-001, SYM-001 e NUM-001. Forneça a cada descoberta uma localização exata de arquivo e linha quando os arquivos estiverem disponíveis; caso contrário, use a seção, equação, tabela, algoritmo, legenda ou âncora de texto citado mais estável disponível.

Use PROBLEMA RELATADO para uma inconsistência confirmada. Use DECISÃO DO AUTOR REQUERIDA quando as evidências não puderem estabelecer se os usos comparados se referem à mesma entidade, conceito, quantidade ou condição experimental, ou se sua diferença é intencional. Mantenha a certeza do conflito separada da remediação: um conflito confirmado permanece PROBLEMA RELATADO mesmo quando o autor ainda deve escolher o termo, símbolo ou valor de substituição.

Porta de Completude de Manuscrito Completo

Reivindique cobertura de MANUSCRITO COMPLETO somente depois que todas as seguintes condições forem verdadeiras:

1. Identifique o arquivo TeX raiz autoritativo e resolva cada \input, \include, \subfile, \import e inclusão equivalente estaticamente alcançável em ordem de documento.
2. Considere inclusões ausentes, condicionais, geradas por macro, geradas ou cíclicas e todo apêndice ou suplemento que carregue notação.
3. Inspecione macros de usuário que produzem notação e ambientes matemáticos personalizados; não confie em uma passagem de script de preservação para expandi-los ou entendê-los.
4. Inspecione notação e alegações numéricas em prosa, equações, algoritmos, legendas, tabelas e ativos de figura fornecidos. Se um ativo contiver texto embutido relevante, mas não puder ser inspecionado, a cobertura é parcial. Se a normalização afetar uma figura, mas a fonte editável não estiver disponível, a normalização está incompleta.
5. Retenha localizações de arquivo e linha relativas à raiz para descobertas e verifique se nenhum escopo solicitado foi pulado.

Se alguma condição falhar, declare a lacuna de cobertura e use Cobertura: PARCIAL. Um upload de arquivo completo não estabelece por si só cobertura analítica completa.

Regras Inegociáveis

• Preserve estruturas TeX, ambientes, citações, rótulos, referências, chaves de bibliografia, nomes de funções, nomes de módulos, nomes de conjuntos de dados, nomes de métricas e significado técnico.
• Preserve argumentos e chaves exatos dentro de comandos estruturais como \label{...}, \ref{...}, \eqref{...}, \includegraphics{...}, comandos de citação, \bibitem{...} e chaves BibTeX. Não renomeie, mescle, exclua, reordene ou normalize-os.
• Trate comentários e fonte literal ou semelhante a código, incluindo comment, verbatim, ambientes de listagem e comandos literais embutidos, como fonte protegida exata em todos os modos. Não mova prosa para dentro ou para fora dessas regiões, mude um comentário embutido para um comentário de linha inteira ou mova-os através de matemática protegida ou estruturas TeX.
• Preserve toda região matemática original e sua ordem de documento durante polimento, tradução, adição de prosa e verificação. A única exceção é uma substituição exata listada em um mapeamento de notação aprovado pelo autor.
• Preserve todo número, unidade, porcentagem, dimensão, parâmetro, tamanho de amostra, valor de tabela, valor relatado em figura, marcador de significância, ordem de token numérico e sinal positivo, negativo ou de mais-menos durante polimento, tradução, adição de prosa, verificação, auditoria de consistência e normalização de notação. Isso inclui dígitos incorporados em identificadores e tokens numéricos dentro de comentários, exemplos literais, URLs ou argumentos de comando protegidos. Não há exceção de edição numérica neste skill, e --allow-additions não relaxa esta regra.
• Trate preservação fonte-para-saída e consistência interna da fonte como verificações separadas. Conflitos internos de terminologia, símbolo, valor, unidade ou sinal são descobertas, não permissão para editar.
• Nunca corrija um valor suspeito neste skill. Após relatar uma descoberta NUM-*, peça ao usuário para revisar a fonte externamente e retornar uma linha de base aprovada pelo autor.
• Não altere definições matemáticas, condições de teorema, lógica de prova, etapas de algoritmo, configurações experimentais, resultados relatados, linhas de base ou conjuntos de dados.
• Não modifique registros bibliográficos ou identificadores neste skill. Uma solicitação de limpeza de referência pode autorizar apenas edições de metadados não numéricos e não identificadores que não entrem em conflito com outra regra protegida; anos, páginas, volumes, números de edição, identificadores DOI/URL/arXiv e todo outro token numérico devem ser corrigidos fora do polidor de artigos e retornados como uma linha de base aprovada pelo autor.
• Não invente alegações, experimentos, garantias, valor de implantação, limitações ou conclusões.
• Não varie termos técnicos meramente por variedade estilística. Use termos canônicos apenas quando seu mapeamento de entidade for suportado.
• Evite repetição mecânica em aberturas de frases, ordem de cláusulas, voz, transições e estrutura de parágrafo sem alterar conteúdo protegido.
• Não use pontuação de travessão na prosa do manuscrito escrito pelo autor. Preserve hífens lexicais, sinais de menos matemáticos, valores sinalizados, chaves protegidas, URLs, strings DOI, nomes de arquivo, chaves de citação e metadados bibliográficos exatamente.

Se uma edição solicitada violar essas regras e não for coberta por um mapeamento aprovado exato, pare essa edição e relate qual autorização ou informação de fonte está faltando. Se seu próprio rascunho violar uma regra, revise-o antes de retorná-lo.

Fluxo de Trabalho

1. Selecione o modo a partir da intenção explícita do usuário e identifique o escopo fornecido.
2. Para trabalho de manuscrito completo, aplique a porta de completude e preserve a ordem de documento resolvida.
3. Construa os registros relevantes:
   • terminologia: entidade, termo canônico, formas contextuais permitidas, definições e localizações;
   • notação: entidade matemática, símbolo, definições e usos, escopo, tipo ou dimensões, quadro e aliases;
   • numérico: quantidade medida ou configurada, valor, unidade, sinal, condição, localização na fonte e usos correspondentes em prosa/tabela/figura.
4. No modo de polimento, revise a prosa mantendo a matemática protegida e a ordem de token numérico fixas. Reordene cláusulas ou frases apenas quando isso não reordenar matemática protegida, números, unidades ou sinais.
5. Execute verificações de consistência bidirecionais: entidade para termo ou símbolo, termo ou símbolo para entidade, e quantidade ou condição experimental para valor, unidade e sinal relatados.
6. Execute verificações de arquitetura de frase, prosa sem travessão, tom objetivo e limites de alegação em todo o escopo avaliado.
7. Quando arquivos original e candidato estiverem disponíveis, execute o verificador de preservação. Use o modo de projeto para um manuscrito com vários arquivos.
8. Retorne a saída específica do modo e distinga alterações autorizadas, descobertas em nível de fonte, desvios introduzidos pelo candidato e verificações não avaliadas.

Verificador de Preservação

Para um arquivo TeX original e um candidato, execute comparação estrita:

python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex

Use --allow-additions apenas quando o usuário autorizou adições de prosa comuns:

python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex --allow-additions

Esta opção não permite chaves estruturais novas, excluídas, alteradas ou reordenadas, regiões matemáticas, tokens numéricos, unidades ou sinais. Comentários reconhecidos e regiões literais ou semelhantes a código permanecem fonte protegida exata, incluindo seu limite de comentário embutido versus linha inteira e sua ordem relativa à matemática protegida e TeX. Compare manualmente qualquer macro literal personalizada ou não reconhecida. Não autoriza novas figuras, tabelas, equações, referências, ativos de imagem ou mapeamentos de símbolos. Estabeleça uma linha de base aprovada pelo autor para mudanças estruturais protegidas intencionais, ou use TeX corrigido externamente e aprovado pelo autor como a nova linha de base quando o conteúdo numérico teve que ser corrigido fora do polidor de artigos.

Para um manuscrito com vários arquivos, passe os dois arquivos TeX raiz autoritativos e habilite a travessia de projeto:

python3 paper-polisher/scripts/check_preservation.py original/main.tex candidate/main.tex --project

O modo de projeto resolve diretivas \input, \include, \subfile, \subfileinclude, \import, \subimport, \inputfrom, \subinputfrom, \includefrom e \subincludefrom estaticamente alcançáveis a partir de cada raiz, incluindo atual e anterior...