Communitygithub.com

CeobeFA333/codex-scientific-diagram-visio

Creación de figuras de modelos científicos basadas en evidencia: desde código y artículos a diagramas nativos editables en Microsoft Visio.

¿Qué es codex-scientific-diagram-visio?

Esta herramienta te permite construir, revisar o auditar diagramas de arquitectura científica en Microsoft Visio, garantizando precisión científica, geometría legible y capacidad de edición nativa. Es útil para investigadores, ingenieros de machine learning y desarrolladores que necesitan convertir implementaciones de código o descripciones de manuscritos en figuras vectoriales editables en Visio. La herramienta soporta tres modos: reconstrucción completa, revisión local y auditoría/exportación. Antes de dibujar, se debe congelar un contrato del modelo con evidencia de código, configuraciones, manuscritos o figuras antiguas, priorizando fuentes que se hayan ejecutado o entrenado con éxito. Luego se protegen los archivos fuente, se usan scripts de automatización de Windows para controlar Visio, y se dibuja en pases ordenados: desde geometría básica hasta detalles, conectores, etiquetas y limpieza visual. Finalmente se guarda, reabre y verifica la editabilidad seleccionando objetos individuales, y se exporta a PDF y PNG de alta resolución. La herramienta incluye referencias como `handoff-contract.md`, `visio-execution.md`, `layout-and-style.md` y `qa-checklist.md` que guían cada paso del flujo de trabajo.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add CeobeFA333/codex-scientific-diagram-visio

Preguntar en tu IA favorita

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

Documentación

Diagrama de Modelo Científico Visio

Crea o revisa una figura de arquitectura científica en Microsoft Visio utilizando objetos nativos editables. Trata la corrección científica, la geometría legible y la editabilidad como compuertas separadas; pásalas todas antes de la entrega.

Elige el modo

  • Reconstrucción completa: construye la página solicitada a partir de un contrato de modelo verificado y una referencia visual.
  • Revisión local: haz una copia de seguridad del VSDX y cambia solo las etapas, símbolos, dimensiones, conectores, tipografía o espaciado nombrados.
  • Auditoría/exportación: inspecciona un VSDX existente, corrige solo los defectos autorizados, vuelve a abrirlo y exporta PDF más PNG a 300 DPI.

Si la lógica fuente no se ha reconciliado entre código, configuración, manuscrito y figuras antiguas, primero usa scientific-model-diagram-prompting o realiza el pase de evidencias en handoff-contract.md. Nunca infieras una operación de fusión o una dimensión de tensor solo por la apariencia visual.

Flujo de trabajo obligatorio

1. Congela el modelo objetivo

Crea un contrato de modelo que contenga: orden de las etapas, forma del tensor en cada límite, semántica de las operaciones, parámetros entrenables, regla de fusión, anchos del clasificador, número de clases y etiquetas exactas. Cita archivos fuente y números de línea cuando haya código o manuscrito disponible.

Aplica esta prioridad de evidencia a menos que el usuario elija explícitamente otro objetivo:

  1. modelo construido o ejecutado con éxito;
  2. implementación de entrenamiento y configuración del experimento;
  3. ecuaciones del manuscrito y texto del método;
  4. VSDX antiguo o figura rasterizada;
  5. referencia visual generada.

Detente e informa contradicciones no resueltas antes de dibujar cuando estas cambiarían materialmente la arquitectura. Lee handoff-contract.md para el esquema de transferencia requerido.

2. Protege la fuente y aísla los archivos de trabajo

  • Resuelve las rutas del VSDX fuente y las rutas de salida exactas antes de editar.
  • Usa el directorio de trabajo nombrado por el usuario. Si no se proporciona ninguno, crea un directorio hermano _visio_work.
  • Mantén capturas de pantalla, imágenes rasterizadas de referencia, copias de seguridad con marca de tiempo, exportaciones temporales, renders de control de calidad y resultados de ayuda dentro de ese directorio de trabajo.
  • Haz una copia de seguridad del VSDX fuente antes de la primera mutación. No sobrescribas la única copia.
  • Elimina páginas no relacionadas solo cuando el usuario lo autorice y después de registrar los nombres de las páginas en el registro de trabajo.

3. Controla Microsoft Visio deliberadamente

Usa la habilidad de automatización de Windows computer-use cuando esté disponible. Antes de la primera acción de UI en una sesión nueva, inicializa su tiempo de ejecución y lee sky.documentation("guidance"); lee sky.documentation("confirmations") antes de acciones que puedan requerir confirmación. Apunta a la ventana de Visio por identidad de aplicación/ventana e inspecciona capturas de pantalla en lugar de usar secuencias de coordenadas ciegas.

Abre el VSDX en Microsoft Visio. No reemplaces la ejecución de Visio con un raster, una captura de pantalla SVG, PowerPoint o un editor de diagramas genérico cuando el usuario solicitó Visio.

Lee visio-execution.md antes de controlar Visio.

4. Construye geometría antes que detalle

Establece el tamaño de página, orientación, márgenes, capas, contenedores de etapa, líneas base de fila y corredores de conectores antes de colocar módulos. Usa un plano de coordenadas y geometría repetida para ramas paralelas.

Crea maestros nativos reutilizables o formas agrupadas para componentes repetidos. Mantén operandos, operadores, dimensiones y conectores independientes. Un cuboide 3D debe seguir siendo un grupo de caras frontal/superior/lateral editables; nunca aplastes la página.

Usa layout-and-style.md para tokens de diseño, tamaños de fuente, construcción de cuboides, conectores, agrupación y los estándares de publicación del usuario.

5. Dibuja en pases

Realiza estos pases en orden:

  1. página, capas y contenedores;
  2. guías de fila repetidas y corredores de conectores;
  3. módulos y cuboides reutilizables;
  4. operandos matemáticos y operadores independientes;
  5. conectores pegados a puntos de conexión;
  6. etiquetas, dimensiones, leyenda y título;
  7. alineación, distribución y agrupación local;
  8. limpieza visual a escala de vista previa y detalle original.

Después de cada pase importante, captura una captura de pantalla en el directorio de trabajo. Si se solicita una revisión local, cambia solo la región afectada y vuelve a verificar sus conexiones entrantes y salientes.

6. Aplica enrutamiento y legibilidad

  • Prefiere líneas de rama perfectamente horizontales y curvas ortogonales.
  • Reserva carriles de conectores vacíos antes de colocar texto.
  • Pega cada conector funcional a puntos de conexión explícitos.
  • Nunca pases una línea a través de texto, un operador, un cuboide, una tarjeta de gráfico u otra punta de flecha.
  • Mantén filas paralelas iguales en altura y espaciado; usa Alinear y Distribuir en lugar de hacerlo a ojo.
  • Acorta etiquetas o ensancha contenedores antes de reducir texto por debajo del tamaño mínimo.
  • Inspecciona tanto una vista previa de página completa como una captura de pantalla ampliada. El texto que solo es legible al hacer zoom falla.

7. Guarda, vuelve a abrir y verifica la editabilidad

Guarda el VSDX final en la ruta solicitada, ciérralo y vuelve a abrirlo en Visio. Selecciona y edita individualmente al menos:

  • una cara dentro de un cuboide agrupado;
  • un operador o símbolo matemático;
  • un conector y ambos puntos finales pegados;
  • una etiqueta de etapa.

Confirma que la imagen de referencia se haya eliminado u ocultado en una capa de Referencia bloqueada, que las páginas no relacionadas estén ausentes cuando se haya solicitado, y que ningún objeto se haya convertido en un mapa de bits de página completa único.

Ejecuta scripts/inspect_vsdx.py después de guardar. Esta comprobación estática complementa pero nunca reemplaza la inspección visual.

8. Exporta y realiza el control de calidad final

Exporta PDF y PNG desde Visio. Para una página de 16 × 9 pulgadas, un raster a 300 DPI tiene al menos 4800 × 2700 píxeles. Inspecciona ambas exportaciones en busca de recortes, sustitución de fuentes, líneas finas/rotas, artefactos de sombra y errores en los límites de página.

Ejecuta la lista de verificación de control de calidad completa qa-checklist.md. No entregues mientras falle cualquier elemento de fidelidad científica, superposición, conector, integridad de texto, exportación o editabilidad.

Reglas de revisión local

  • Preserva formas, estilos, capas y configuraciones de página no afectados.
  • Haz una copia de seguridad antes de editar y guarda la revisión bajo una nueva versión hasta que se acepte.
  • Diagnostica el subgrafo afectado más pequeño: conector entrante, objetos editados, conector saliente.
  • Vuelve a enrutar conectores adyacentes después de mover cualquier objeto.
  • Vuelve a ejecutar la revisión de vista previa de página completa; una corrección local puede crear una colisión global.

Transferencia requerida

Informa:

  1. arquitectura objetivo y base de evidencia;
  2. rutas de origen, copia de seguridad, directorio de trabajo y salida;
  3. páginas eliminadas o conservadas;
  4. rutas VSDX, PDF y PNG, más tamaño de píxel/DPI del PNG;
  5. resumen de inspección estática del VSDX;
  6. pruebas de reapertura/editabilidad realizadas;
  7. cualquier incertidumbre restante.

No afirmes éxito solo porque el archivo se guardó o exportó.

Skills relacionados