Communitygithub.com

Paper Format Agent

Formateador de documentos DOCX para trabajos académicos con un guardián de huella de contenido: prueba que tu texto nunca se modifica, solo el formato. También instalable como habilidad de agente.

¿Qué es Paper Format Agent?

Este agente especializado en formato de documentos académicos opera localmente, garantizando la integridad del contenido mediante un mecanismo de 'huella de contenido'. Está diseñado para archivos .docx y una especificación de formato separada, y su flujo de trabajo principal consiste en ejecutar un CLI que extrae reglas de formato, aplica cambios de formato y genera informes detallados de verificación. Soporta múltiples formatos de entrada para la guía de formato (.docx, .doc, .txt) y produce artefactos como el documento formateado, reglas extraídas, informes legibles por máquina y humanos, y un registro de modificaciones. El agente se ejecuta de forma predeterminada en modo solo formato, y el campo 'content_changed' en format_report.json debe ser false a menos que el usuario opte explícitamente por cambios de contenido. Es adecuado para integración con plataformas como Claude Code, Cursor o Codex, ya que se describe como 'instalable como habilidad de agente'.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add zxyasfas/paper_format_agent

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Paper Format Agent?

Usa esta habilidad para el formateo de documentos académicos con prioridad local. Está diseñada para documentos .docx y una especificación de formato separada en .docx, .doc o .txt.

Valores Predeterminados de Seguridad

  • Nunca subas documentos privados o guías de formato a servicios externos a menos que el usuario lo solicite explícitamente.
  • Trata los trabajos de estudiantes, manuscritos, comentarios de revisores y plantillas escolares como datos sensibles.
  • No modifiques el contenido académico a menos que el usuario opte explícitamente. Por defecto, solo se realizan cambios de formato.
  • Mantén los informes y documentos generados en un directorio de salida proporcionado por el usuario.

Flujo de Trabajo Estándar

  1. Confirma los archivos de entrada:
    • --format-file: guía de formato o texto de plantilla.
    • --paper-file: documento fuente, actualmente .docx.
    • --out-dir: directorio de salida para informes y documentos generados.
  2. Ejecuta el CLI en modo solo formato:
python -m paper_format_agent.cli \
  --format-file "format_guide.docx" \
  --paper-file "paper.docx" \
  --out-dir "./output" \
  --engine auto \
  --strict-required-sections
  1. Inspecciona los artefactos generados:
    • formatted_paper_v3.docx: documento reparado.
    • format_rules.json: reglas extraídas.
    • format_report.json: puntuación y comprobaciones legibles por máquina.
    • format_report.html: informe legible por humanos.
    • modify_log.json: operaciones de formato.
    • engine_report.json: resultado del motor de postprocesamiento.
  2. Verifica los campos de guardián de contenido en format_report.json:
    • content_changed normalmente debe ser false.
    • content_guard_enforced normalmente debe ser true.
  3. Si una regla es incorrecta, actualiza la lógica de extracción o puntuación de reglas y añade un caso de prueba mínimo.

Validación

Ejecuta estos antes de entregar el trabajo:

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

Al Añadir Soporte para Plantillas

  • Añade el texto de regla representativo más pequeño necesario para reproducir el comportamiento.
  • Prefiere la extracción determinista de reglas sobre la interpretación exclusiva con LLM.
  • Añade pruebas para márgenes extraídos, tamaño de fuente, interlineado, secciones requeridas, encabezados, títulos de figuras o referencias.
  • No subas documentos reales de estudiantes. Usa texto sintético o fixtures anonimizados.

Al Revisar la Salida

Lee format_report.json primero, luego inspecciona format_report.html si el usuario necesita un resumen legible por humanos. Prioriza los problemas en este orden:

  1. Contenido cambiado inesperadamente.
  2. Secciones requeridas o encabezados mal clasificados.
  3. Configuración de página, márgenes, fuentes o interlineado incorrectos.
  4. Títulos de figuras, referencias, tablas o numeración con aspecto incorrecto.
  5. Redacción del informe o explicación de la puntuación poco clara.

Tareas Amigables para Contribuciones

Las buenas primeras solicitudes de extracción suelen encajar en una de estas categorías:

  • Añadir una prueba sintética para una regla de formato escolar, de revista o de conferencia.
  • Mejorar un extractor de reglas con una expresión regular o analizador de alcance limitado.
  • Mejorar la claridad del informe sin cambiar la semántica de puntuación.
  • Añadir un caso de regresión a docs/regression_manifest.sample.json.
  • Mejorar este flujo de trabajo de habilidad o los metadatos de agents/openai.yaml.

Skills relacionados