Communitygithub.com

Pulidor de Artículos

Pulir, traducir o revisar fielmente manuscritos académicos en TeX en chino o inglés; verificar la preservación de TeX, matemáticas, citas, valores numéricos y afirmaciones desde la fuente hasta la salida; auditar la coherencia terminológica, notación matemática y numérica entre secciones; o aplicar un mapeo de notación aprobado por el autor.

¿Qué es Pulidor de Artículos?

Este skill está diseñado para el pulido de manuscritos académicos en TeX (principalmente en chino e inglés) con un enfoque en ingeniería y ciencias exactas. Su función principal es preservar todos los elementos protegidos de TeX (estructuras, comandos, citas, etiquetas, entorno matemático, etc.) mientras se mejora la prosa, se traduce o se realiza una auditoría de coherencia. No se debe usar para evaluar novedad, revisión bibliográfica o rediseño del argumento principal del artículo. El skill distingue cuatro modos de operación: pulido por defecto, verificación, auditoría de coherencia y normalización de notación aprobada. Cada modo tiene reglas estrictas sobre qué se puede modificar y qué debe permanecer inalterado. Por ejemplo, en modo verificación, no se permite corregir el documento candidato; solo se reportan desviaciones. En modo de normalización, solo se aplican sustituciones de símbolos explícitamente aprobadas por el autor. El skill impone reglas no negociables: preservar números, unidades, signos, órdenes de tokens numéricos, identificadores de citas y bibliografía, y no modificar definiciones matemáticas, pruebas lógicas o resultados reportados. También implementa un protocolo de cobertura y resultado para auditorías, con identificadores deterministas (TERM-*, SYM-*, NUM-*) y un 'Completeness Gate' para manuscritos completos que verifica la inclusión de todos los archivos y entornos. Finalmente, incluye un verificador de preservación basado en un script de Python (`check_preservation.py`) que compara estrictamente el archivo original con el candidato, permitiendo solo adiciones de prosa ordinaria bajo la opción `--allow-additions`. El skill está diseñado para plataformas como Claude Code, Cursor o Codex que ejecuten scripts de Python.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BorisW269/skills/tree/HEAD/skills/paper-polisher

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Pulidor de Artículos?

Alcance y Referencias

Utilice este skill para pulido académico seguro en TeX en inglés, traducción, corrección de pruebas, verificación fuente-a-salida, revisión de terminología o notación, revisión de coherencia numérica y normalización de notación explícitamente autorizada.

Para artículos completos, secciones largas, verificación, auditorías de coherencia, normalización o trabajo de guía de estilo estricta, lea references/tex_safe_polishing.md antes de actuar. Lea references/tex_safe_polishing_zh.md en su lugar cuando una guía de flujo de trabajo en chino sea materialmente útil; no cargue ambos solo para duplicar contexto. Para un pulido local corto, use las reglas principales a continuación y consulte una referencia solo cuando sea necesario.

No use este skill como la herramienta principal para:

  • auditorías de novedad, defensibilidad de contribución, línea base peligrosa o ataques de revisores; use idea-novelty-auditor si está disponible;
  • revisión bibliográfica, encuadre de brechas, selección de referencias o asignación de roles de citas; use problem-driven-literature-review si está disponible;
  • rediseño general de la historia, estructura de la introducción o experimento a afirmación; use paper-argument-reconstructor si está disponible.

Cuando una solicitud combine esas tareas con el pulido, complete la tarea de razonamiento ascendente primero y use este skill solo para el paso final de pulido fiel de lenguaje y coherencia.

Selección de Modo y Precedencia

Siga la acción explícita solicitada por el usuario antes de considerar quién produjo la entrada. La procedencia por sí sola nunca anula una solicitud explícita de pulir, auditar, verificar o normalizar. Si se solicita más de una acción, mantenga sus artefactos e informes separados a menos que el usuario solicite un entregable combinado.

Las reglas de salida específicas del modo tienen prioridad sobre las reglas de salida basadas en la longitud del documento. En particular, una verificación de manuscrito completo o una auditoría de solo coherencia sigue siendo solo un informe.

Si el usuario solicita tanto normalización de notación como pulido de prosa, realice y apruebe la normalización primero, trate el TeX normalizado como la nueva línea base, y luego pula contra esa línea base. No intente validar un cambio combinado de prosa y símbolo como una comparación de normalización.

Modo de Pulido Predeterminado

Pula o traduzca el texto proporcionado mientras preserva cada elemento protegido. Para un manuscrito completo, también ejecute auditorías de coherencia terminológica, de notación y numérica interna de la fuente, e informe los problemas a nivel de fuente sin corregirlos silenciosamente.

Modo de Verificación

Use el modo de verificación cuando el usuario solicite comparar o verificar la calidad de un candidato contra un original.

  • Requiera tanto el original como el candidato para cada juicio comparativo sobre TeX, matemáticas, números, unidades, signos, citas, significado técnico o fuerza de la afirmación.
  • Si el original no está disponible, inspeccione solo las propiedades intrínsecas del candidato y marque cada verificación comparativa de fuente como NO EVALUADO; nunca infiera preservación solo del candidato.
  • Nunca reescriba o repare el candidato en modo de verificación, incluidas las violaciones de reglas estrictas. Informe cada desviación y su ubicación. Aplique correcciones solo en un turno o modo de edición separado y explícitamente solicitado.
  • Separe las desviaciones introducidas por el candidato de los conflictos terminológicos, de notación o numéricos ya presentes en la fuente.

Modo de Auditoría de Coherencia

Cuando el usuario solicite solo coherencia terminológica, de variables, símbolos, notación o numérica, no reescriba el manuscrito. Audite el alcance disponible e informe hallazgos TERM-*, SYM-* y NUM-* según corresponda. Mantenga el texto fuente, símbolos, valores, unidades y signos sin cambios.

Modo de Normalización de Notación Aprobada

Use este modo solo cuando el usuario solicite explícitamente normalización y haya aprobado un mapeo exacto de símbolos. Un mapeo aprobado debe identificar la entidad matemática, los símbolos antiguo y nuevo, el alcance o las ubicaciones afectadas, y cualquier alias o exclusión intencional.

  • Aplique solo las sustituciones de símbolos aprobadas. No reinterprete definiciones ni elija un símbolo canónico en nombre del usuario.
  • Registre cada sustitución aplicada como CAMBIO AUTORIZADO; trate cada diferencia matemática, estructural, textual o numérica no mapeada como un error.
  • Mantenga todos los números, unidades, porcentajes, dimensiones, tamaños de muestra, orden de tokens numéricos y signos positivos, negativos o más-menos sin cambios.
  • Si un símbolo afectado ocurre dentro de un activo de figura no disponible o no editable, entorno personalizado, archivo generado o expansión de macro no resuelta, informe la ubicación no resuelta y no reclame normalización completa.
  • Valide el resultado normalizado contra el mapeo aprobado. Si la comparación consciente del mapeo no está disponible, obtenga la aprobación del TeX normalizado como una nueva línea base aprobada por el autor, luego use una comparación estricta contra esa línea base para todo el pulido posterior.

No use --allow-additions para autorizar cambios de símbolos. No modifique un número, unidad o signo numérico en ningún modo de pulidor de artículos, incluso después de informar un conflicto NUM-*. Pida al usuario que corrija la fuente fuera de este skill y proporcione el TeX corregido como una nueva línea base aprobada por el autor; nunca infiera ni aplique un valor de reemplazo.

Protocolo de Cobertura y Resultado Compartido

Informe la cobertura y el resultado por separado para cada auditoría de coherencia terminológica, de notación y numérica.

  • Cobertura: MANUSCRITO COMPLETO significa que la puerta de integridad a continuación pasó.
  • Cobertura: PARCIAL significa que solo se auditó el alcance local o resoluble indicado.
  • Resultado: APROBADO significa que no se encontró ningún conflicto o ambigüedad no resuelta dentro del alcance evaluado.
  • Resultado: PROBLEMA REPORTADO significa que se encontró al menos una inconsistencia clara y ningún hallazgo requiere aún una decisión del autor.
  • Resultado: DECISIÓN DEL AUTOR REQUERIDA significa que al menos un hallazgo plausible no puede resolverse solo a partir del manuscrito. Los problemas confirmados permanecen etiquetados individualmente como PROBLEMA REPORTADO.
  • Resultado: NO EVALUADO significa que esa auditoría o comparación no pudo realizarse en absoluto. No lo use meramente porque la cobertura sea parcial.

Asigne identificadores de hallazgos deterministas en orden de archivo y fuente relativo a la raíz: TERM-001, SYM-001 y NUM-001. Proporcione a cada hallazgo una ubicación exacta de archivo y línea cuando los archivos estén disponibles; de lo contrario, use la sección, ecuación, tabla, algoritmo, leyenda o ancla de texto citado más estable disponible.

Use PROBLEMA REPORTADO para una inconsistencia confirmada. Use DECISIÓN DEL AUTOR REQUERIDA cuando la evidencia no pueda establecer si los usos comparados se refieren a la misma entidad, concepto, cantidad o condición experimental, o si su diferencia es intencional. Mantenga la certeza del conflicto separada de la corrección: un conflicto confirmado sigue siendo PROBLEMA REPORTADO incluso cuando el autor aún debe elegir el término, símbolo o valor de reemplazo.

Puerta de Integridad de Manuscrito Completo

Reclame cobertura de MANUSCRITO COMPLETO solo después de que todo lo siguiente sea cierto:

  1. Identifique el archivo TeX raíz autoritativo y resuelva cada \input, \include, \subfile, \import e inclusión equivalente estáticamente alcanzable en orden de documento.
  2. Considere las inclusiones faltantes, condicionales, generadas por macros, generadas o cíclicas y cada apéndice o suplemento que contenga notación.
  3. Inspeccione macros de usuario que producen notación y entornos matemáticos personalizados; no confíe en un pase de script de preservación para expandirlos o comprenderlos.
  4. Inspeccione la notación y las afirmaciones numéricas en prosa, ecuaciones, algoritmos, leyendas, tablas y activos de figuras proporcionadas. Si un activo contiene texto incrustado relevante pero no puede ser inspeccionado, la cobertura es parcial. Si la normalización afecta una figura pero la fuente editable no está disponible, la normalización está incompleta.
  5. Retenga las ubicaciones de archivo y línea relativas a la raíz para los hallazgos y verifique que no se haya omitido ningún alcance solicitado.

Si alguna condición falla, indique la brecha de cobertura y use Cobertura: PARCIAL. Una carga de archivo completa no establece por sí misma una cobertura analítica completa.

Reglas No Negociables

  • Preserve las estructuras TeX, entornos, citas, etiquetas, referencias, claves de bibliografía, nombres de funciones, nombres de módulos, nombres de conjuntos de datos, nombres de métricas y significado técnico.
  • Preserve los argumentos y claves exactos dentro de comandos estructurales como \label{...}, \ref{...}, \eqref{...}, \includegraphics{...}, comandos de cita, \bibitem{...} y claves BibTeX. No los renombre, fusione, elimine, reordene ni normalice.
  • Trate los comentarios y la fuente literal o similar a código, incluidos comment, verbatim, entornos de listado y comandos literales en línea, como fuente protegida exacta en cada modo. No mueva prosa hacia o desde estas regiones, cambie un comentario en línea a un comentario de línea completa, ni los mueva a través de matemáticas protegidas o estructuras TeX.
  • Preserve cada región matemática original y su orden de documento durante el pulido, la traducción, la adición de prosa y la verificación. La única excepción es una sustitución exacta enumerada en un mapeo de notación aprobado por el autor.
  • Preserve cada número, unidad, porcentaje, dimensión, parámetro, tamaño de muestra, valor de tabla, valor reportado en figura, marcador de significancia, orden de tokens numéricos y signo positivo, negativo o más-menos durante el pulido, la traducción, la adición de prosa, la verificación, la auditoría de coherencia y la normalización de notación. Esto incluye dígitos incrustados en identificadores y tokens numéricos dentro de comentarios, ejemplos literales, URL o argumentos de comandos protegidos. No hay excepción de edición numérica en este skill, y --allow-additions no relaja esta regla.
  • Trate la preservación fuente-a-salida y la coherencia interna de la fuente como verificaciones separadas. Los conflictos internos de terminología, símbolo, valor, unidad o signo son hallazgos, no permiso para editar.
  • Nunca corrija un valor sospechoso en este skill. Después de informar un hallazgo NUM-*, pida al usuario que revise la fuente externamente y devuelva una línea base aprobada por el autor.
  • No altere definiciones matemáticas, condiciones de teoremas, lógica de pruebas, pasos de algoritmos, configuraciones experimentales, resultados reportados, líneas base o conjuntos de datos.
  • No modifique registros o identificadores de bibliografía en este skill. Una solicitud de limpieza de referencias puede autorizar solo ediciones de metadatos no numéricos y no identificadores que no entren en conflicto con otra regla protegida; los años, páginas, volúmenes, números de edición, identificadores DOI/URL/arXiv y cada otro token numérico deben corregirse fuera del pulidor de artículos y devolverse como una línea base aprobada por el autor.
  • No invente afirmaciones, experimentos, garantías, valor de implementación, limitaciones o conclusiones.
  • No varíe términos técnicos meramente por variedad estilística. Use solo términos canónicos cuando su mapeo de entidad esté respaldado.
  • Evite la repetición mecánica en los inicios de oraciones, orden de cláusulas, voz, transiciones y estructura de párrafos sin cambiar el contenido protegido.
  • No use puntuación de guiones en la prosa del manuscrito escrito por el autor. Preserve exactamente los guiones léxicos, signos menos matemáticos, valores con signo, claves protegidas, URL, cadenas DOI, nombres de archivo, claves de cita y metadatos de bibliografía.

Si una edición solicitada violara estas reglas y no está cubierta por un mapeo aprobado exacto, detenga esa edición e informe qué autorización o información de fuente falta. Si su propio borrador viola una regla, revíselo antes de devolverlo.

Flujo de Trabajo

  1. Seleccione el modo a partir de la intención explícita del usuario e identifique el alcance proporcionado.
  2. Para trabajo de manuscrito completo, aplique la puerta de integridad y preserve el orden de documento resuelto.
  3. Construya los registros relevantes:
    • terminología: entidad, término canónico, formas contextuales permitidas, definiciones y ubicaciones;
    • notación: entidad matemática, símbolo, definiciones y usos, alcance, tipo o dimensiones, marco y alias;
    • numérico: cantidad medida o configurada, valor, unidad, signo, condición, ubicación de fuente y usos coincidentes en prosa/tabla/figura.
  4. En modo de pulido, revise la prosa mientras mantiene fijo el orden de las matemáticas protegidas y los tokens numéricos. Reordene cláusulas u oraciones solo cuando hacerlo no reordene matemáticas protegidas, números, unidades o signos.
  5. Ejecute verificaciones de coherencia bidireccionales: entidad a término o símbolo, término o símbolo a entidad, y cantidad o condición experimental a valor, unidad y signo reportados.
  6. Ejecute verificaciones de arquitectura de oraciones, prosa sin guiones, tono objetivo y límites de afirmación en el alcance evaluado.
  7. Cuando los archivos original y candidato estén disponibles, ejecute el verificador de preservación. Use el modo de proyecto para un manuscrito de varios archivos.
  8. Devuelva la salida específica del modo y distinga los cambios autorizados, los hallazgos a nivel de fuente, las desviaciones introducidas por el candidato y las verificaciones no evaluadas.

Verificador de Preservación

Para un archivo TeX original y candidato, ejecute una comparación estricta:

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

Use --allow-additions solo cuando el usuario haya autorizado adiciones ordinarias de prosa:

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

Esta opción no permite claves estructurales nuevas, eliminadas, cambiadas o reordenadas, regiones matemáticas, tokens numéricos, unidades o signos. Los comentarios reconocidos y las regiones literales o similares a código siguen siendo fuente protegida exacta, incluido su límite de comentario en línea versus de línea completa y su orden relativo a las matemáticas protegidas y TeX. Compare manualmente cualquier macro literal personalizada o no reconocida. No autoriza nuevas figuras, tablas, ecuaciones, referencias, activos de imagen o mapeos de símbolos. Establezca una línea base aprobada por el autor para cambios estructurales protegidos intencionales, o use TeX corregido externamente y aprobado por el autor como la nueva línea base cuando el contenido numérico haya tenido que corregirse fuera del pulidor de artículos.

Para un manuscrito de varios archivos, pase los dos archivos TeX raíz autoritativos y habilite el recorrido del proyecto:

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

El modo de proyecto resuelve las directivas \input, \include, \subfile, \subfileinclude, \import, \subimport, \inputfrom, \subinputfrom, \includefrom y \subincludefrom estáticamente alcanzables desde cada raíz, incluyendo los directorios actual y de proyecto.

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

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados