joshua-zyy/academic-paper-writer

Academic Figure

Enrutador de figuras académicas para CS/AI/ML. Las figuras de datos experimentales se entregan por defecto en SVG editable con Python/matplotlib, y se ejecuta un gate de diseño de gráficos CS/AI/ML. Los diagramas de modelos, arquitecturas, vistas generales y mecanismos complejos no entran dentro del alcance de dibujo automático de esta habilidad; si el artículo requiere dichas figuras, solo se pueden generar notas de necesidad de dibujo manual, listas de evidencia, borradores de caption o notas de blueprint de figura.

Protocolo de enrutamiento

1. Leer manifest.yaml. Declara los archivos always_load, los axes y las references.on_demand.
2. Leer cada archivo listado bajo always_load. Estas son las reglas vinculantes de la habilidad, no material de referencia.
3. Aplicar el material cargado como restricciones:
   • stance.md define el trazado solo en Python, el contrato de figura, la política visual y el alcance.
   • red-lines.md define prohibiciones absolutas. No negociar estas.
   • output-contract.md define los entregables por modo.
   • anti-patterns.md define modos de fallo conocidos y sus alternativas correctas.
4. Seleccionar exactamente un mode del manifiesto. Si es ambiguo, hacer solo una pregunta concisa de aclaración cuando falte la fuente de datos o el uso objetivo. Las solicitudes de diagramas de modelo, arquitectura, vista general o mecanismo usan solo figure-blueprint para producir notas manual_figure_needed; nunca renderizar imágenes, SVG o prompts.
5. Reflejar el modo seleccionado al usuario antes de ejecutar.
6. Recurrir a references/ solo cuando se cumpla la condición references.on_demand del manifiesto.

Modos

Modo	Úsese cuando
chart-from-data	Archivos de datos o resultados numéricos, necesita gráfico de publicación con gate de diseño de gráficos CS/AI/ML
figure-blueprint	Quiere sugerencias de figuras para una sección del artículo
figure-audit	Figura existente revisada para preparación de publicación
figure-revision	Figura existente necesita revisión

Despacho de agente

agents/figure_agent.md es despachado por el orquestador en el Paso 6.4. El agente devuelve artefactos de figura, scripts, rutas SVG e informes; no debe editar de forma independiente el código fuente del proyecto ni los datos experimentales.

Criterios de finalización

• chart-from-data: Contrato de figura, gate de diseño de gráficos CS/AI/ML, script de Python, datos fuente, SVG editable, informe de QA — todo pasa.
• figure-audit: Cada elemento de QA tiene estado de aprobado/fallo y remediación concreta.
• figure-blueprint: Cada figura sugerida se asigna a una afirmación del artículo y una fuente de datos/evidencia.
• figure-revision: Artefacto revisado o instrucciones, informe de QA, trazabilidad de evidencia sin cambios.