CommunityImagengithub.com

diagrama-mecanismo-bio-via

Construye o edita diagramas de mecanismos/vías biológicas de calidad para publicación a partir de materiales de investigación (PDF/texto) como una declaración de mecanismo impugnable - modelo de tres capas (entidades tipadas, aristas dirigidas tipadas con evidencia textual, diseño por compartimentos), SVG semánticamente correcto, exportaciones PNG/PDF y un result.json trazable y consciente de incertidumbres.

¿Qué es diagrama-mecanismo-bio-via?

Este skill permite construir o editar diagramas de vías/mecanismos biológicos de calidad para publicación, partiendo de materiales de investigación (PDF, texto). El skill sigue un contrato riguroso: cada entidad y cada arista en el lienzo debe rastrearse hasta una cita textual con localización; la semántica de interacción (activación, inhibición, unión, modificación, transporte) es visualmente distinta y nunca se mezcla. Cualquier información que la fuente no establezca explícitamente (dirección, localización, números) se marca visiblemente como no declarada, evitando conjeturas. Los entregables incluyen un SVG editable por capas y direccionable por ID, exportaciones PNG/PDF y un archivo result.json que cumple con el contrato. El skill está diseñado para plataformas como Claude Code, Cursor y Codex, y se ejecuta en un entorno controlado con scripts Python. Es ideal para tareas como dibujar diagramas de señalización, figuras de mecanismos, diagramas de diafonía entre vías o flujos de vías, y rechaza adivinar direcciones de regulación o inventar datos no explícitos en la fuente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qingyulzx/pku-efficiency3-skills/tree/HEAD/bio-pathway

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

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

Documentación

diagrama-mecanismo-bio-vía

Una figura de vía es una declaración de mecanismo que los lectores impugnarán una flecha a la vez. Contrato de esta habilidad: cada entidad y cada arista en el lienzo se remonta a una cita textual con una localización; la semántica de interacción (activación / inhibición / unión / modificación / transporte) es visualmente distinta y nunca se mezcla; cualquier cosa que la fuente no indique (dirección, localización, números) se marca visiblemente como no declarada, no adivinada. Los entregables son un SVG editable, por capas y direccionable por ID, más exportaciones PNG/PDF y un result.json completo del contrato.

Cuándo usar / cuándo no

Usar para: figuras de mecanismos, diagramas de vías de señalización, cascadas receptor-núcleo, diafonía de vías, tareas de "dibujar la Figura N de este artículo" y ediciones de una figura de vía existente (agregar/eliminar entidad o arista, volver a etiquetar). No para: gráficos estadísticos (barras/caja/volcán), esquemas experimentales o retoques solo estéticos; esos pertenecen a habilidades adyacentes.

Contrato de ejecución (entorno de ejecución de la plataforma)

  • Entrada: /input/case.json (+ task.md). Trabajar bajo /app/work; entregables bajo /app/output.
  • Primera acción de toda la ejecución (antes de leer el caso en profundidad): python scripts/scaffold_result.py --input /input/case.json --outdir /app/output Esto escribe un result.json con cada campo del contrato de salida presente, los no producidos con null + motivo. Manténgalo actualizado paso a paso; nunca elimine un campo del contrato.
  • Todos los scripts siguientes toman rutas de estilo --model/--svg y son Python 3 puro (solo stdlib) a menos que se indique. references/ es leído por los scripts; lea los archivos .md usted mismo antes del Paso 1.

Paso 0 - Leer el contrato y preparar el andamio (1 solicitud)

Ejecute el andamio. Hojeé task.md + case.json: identifique el objetivo de la figura (qué mecanismo, qué figura si se reproduce una, escenario de generar vs editar), los formatos de exportación requeridos y el alcance de la evidencia. Registre la lista de campos del contrato que debe completar. Conciencia de presupuesto: apunte a terminar en 5-8 pasos del modelo; los scripts hacen el trabajo pesado, usted hace la ciencia.

Paso 1 - Extraer el modelo del mecanismo (el núcleo científico - hágalo usted mismo)

Lea el material real (analice el PDF de verdad; lea archivos, nunca asuma contenido a partir de etiquetas). Construya /app/work/model.json según references/layout-conventions.md por su PROPIO criterio:

  1. Entidades — gen / proteína / receptor / ARN / complejo / molécula / célula / familia. Aplique references/naming-rules.md: símbolos de genes en cursiva y nodos de genes distintos de sus proteínas (MYC vs MYC); símbolos preferidos con ortografías de la fuente en sinónimos; familias vs miembros; un nodo por complejo indicado. Cada entidad lleva source: {loc, quote} — una cita TEXTUAL y una localización suficientemente precisa para reencontrarla (sección/párrafo/página/leyenda de figura).
  2. Aristas — tipo del conjunto cerrado en references/edge-types.json (activación, inhibición, unión, fosforilación, ubiquitinación, regulación transcripcional, translocación, formación de complejo, ...). directed debe establecerse explícitamente. Nunca adivine la dirección: si la cita no tiene señal direccional, establezca directed: false y registre una incertidumbre (references/uncertainty-policy.md). La unión/reclutamiento no tiene dirección. La regulación transcripcional tiene como objetivo un nodo de gen y necesita un signo.
  3. Compartimentos — extracelular / membrana / citoplasma / núcleo (+ RE, Golgi, subregiones de orgánulos si el mecanismo los necesita). Las entidades cuya localización no está indicada van a la banda unspecified — nunca silenciosamente al citoplasma. Los receptores se anclan en la banda de membrana.
  4. Orden — establezca order según la posición en la vía (orden topológico, no orden de texto); los bucles de retroalimentación surgen naturalmente como aristas hacia atrás.
  5. Números en el lienzo (expresión, significancia) solo si existen textualmente en la fuente; de lo contrario, deje los mapeos de datos como nulos explícitos.

Orden práctico de extracción: lea una vez para el flujo general; segunda pasada oración por oración para entidades + citas; tercera pasada para aristas, incluidos inhibidores, retroalimentación y diafonía (se esconden en oraciones con "sin embargo/mientras que").

Paso 2 - Validar el modelo (script)

python scripts/validate_model.py --model /app/work/model.json \
    --report /app/work/validation-report.json

Corrija cada error E-*. E-DIR-01 (arista dirigida sin señal direccional) es la protección científica central: o cite una oración que indique dirección o reduzca a no dirigida + incertidumbre. Las advertencias requieren una decisión consciente: nodos de familia, ubicación del receptor, desajustes signo-vs-cita. Vuelva a ejecutar hasta que sea válido. Si el material no puede respaldar un elemento requerido del contrato, anótelo ahora (se convierte en un null + motivo en el Paso 5).

Paso 3 - Renderizar SVG y exportar (scripts)

python scripts/render_svg.py --model /app/work/model.json \
    --out /app/output/pathway.svg --report /app/work/render-report.json
python scripts/export_assets.py --svg /app/output/pathway.svg \
    --outdir /app/output --model /app/work/model.json \
    --png-width 2400 --report /app/work/export-report.json

Lea las advertencias del informe de renderizado (límites del lienzo, compartimentos desconocidos). Mire el PNG usted mismo; si el diseño oscurece el mecanismo (cruce de aristas que oculta una bifurcación, retroalimentación sobre la cascada), ajuste order/posiciones de anclaje en el modelo y vuelva a renderizar. El SVG es determinista: modelo idéntico → SVG idéntico.

Paso 4 - Escenarios de edición (si el caso solicita ediciones de una figura existente)

Reconstruya primero el modelo de la figura objetivo (Paso 1 sobre el texto fuente de la figura original), luego use ediciones que preserven la fuente — el modelo/SVG original se respalda, cada edición se registra en el change_log del modelo:

python scripts/apply_edit.py --model /app/work/model.json --op add-edge \
    --id e-new --src A --tgt B --type inhibition --directed true \
    --sign negative --loc "..." --quote "..."

Operaciones: agregar/renombrar/eliminar entidad (eliminar se niega cuando hay aristas adjuntas a menos que --cascade, y las eliminaciones en cascada se registran como incertidumbres), agregar/eliminar arista, agregar compartimento. Cada entidad/arista agregada REQUIERE --loc + --quote textual. Después de las ediciones, revalide (automático) y vuelva a renderizar (Paso 3).

Paso 5 - Verificar y finalizar result.json (script + usted)

python scripts/verify_outputs.py --model /app/work/model.json \
    --svg /app/output/pathway.svg --result /app/output/result.json \
    --exports /app/output/pathway.png /app/output/pathway.pdf \
    --report /app/output/verification-report.json

Esto relee el SVG y verifica la relectura de nodos/aristas, la consistencia leyenda↔uso en ambas direcciones, el desbordamiento de etiquetas, los límites del lienzo, la existencia de exportaciones y que cada nulo en result.json tenga un motivo. Luego finalice usted mismo result.json: complete los campos del contrato (rutas de editable_source, exportaciones con backend/parámetros, entity_table/edge_table con citas, legend_basis, fuentes con versiones, incertidumbres, resumen de verificación, estado honesto). Mantenga _unanswered_reasons para cualquier cosa nula. La entrega parcial debe indicar sus límites en palabras claras.

Manejo de excepciones (rutas reales, no decoración)

FallaDetecciónAcción
PDF ilegible / sin capa de textoel análisis falla o texto vacíopdf-render-tool / ocr-tool para el renderizado, marcar "capa de texto ausente" en result.json
Nombre de entidad ambiguo (dos lecturas)su extracciónelegir según contexto, registrar alternativa + incertidumbre; si no se puede decidir, null + motivo
Dirección no indicadaE-DIR-01degradar a arista no dirigida (sin punta de flecha) + incertidumbre. NUNCA adivinar
Compartimento desconocidoE-CMP-01 / advertencia de diseñobanda unspecified + nota
Faltan datos numéricos para visuales codificadas por datosel modelo no tiene números textualesdibujar topología, marcar mapeo null + "datos ausentes de la fuente"
Desbordamiento de etiquetaverificar label_overflowacortar etiqueta / dividir en label+sub / reordenar
Lienzo excede límitesadvertencia de renderizadodividir en paneles o reducir ramas; anotarlo
Falta backend de exportaciónestado del informe de exportación fallidocadena de respaldo ya intentada; entregar SVG, registrar falla + guía en result.json
PNG en blanco/degeneradoblank_checkinvestigar informe de renderizado; volver a renderizar; registrar
Persisten errores de validacióncódigo de salida 2corregir modelo; si no se puede corregir a partir del material, entregar el subconjunto válido + límites explícitos

Barra de calidad (autoverificación antes de finalizar)

  1. ¿Podría un revisor señalar cualquier flecha y obtener su justificación textual de la tabla/modelo incrustados? (trazabilidad)
  2. ¿Son visualmente distintas activación/inhibición/unión/modificación, y coincide la leyenda con lo dibujado — sin entradas faltantes ni fantasma?
  3. ¿Está todo lo no indicado visiblemente no indicado (no dirigido, banda unspecified, null + motivo)?
  4. ¿Puede alguien abrir el SVG, cambiar una etiqueta y reexportar? (por capas, direccionable por ID, pila de fuentes estándar)
  5. ¿Cubre result.json cada campo del contrato con estado honesto?

Archivos

  • scripts/scaffold_result.py - result.json completo del contrato con null+motivo
  • scripts/validate_model.py - esquema + verificación de evidencia de dirección + nomenclatura
  • scripts/render_svg.py - SVG determinista por capas a partir de model.json
  • scripts/export_assets.py - PNG/PDF con cadena de respaldo + verificación de blanco
  • scripts/apply_edit.py - ediciones registradas que preservan la fuente
  • scripts/verify_outputs.py - verificación de relectura del paquete
  • references/edge-types.json - semántica de símbolos legible por máquina
  • references/symbol-semantics.md - gramática visual y su razonamiento
  • references/naming-rules.md - convenciones para genes/proteínas/familias/complejos
  • references/uncertainty-policy.md - reglas de degradación; política de nunca adivinar
  • references/layout-conventions.md - esquema model.json + algoritmo de diseño
  • examples/ras-mapk-case/ - un ejemplo práctico con material real (Brown & Ried 2022)
  • README.md - documentación de uso independiente

Individual skills in this repo

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

graphical-abstract-builder

Build a single-page graphical abstract (question, method, results, conclusion) from research material as a traceable, editable SVG with PNG/PDF exports. Use when asked to create or edit a graphical abstract, science summary figure, mechanism or flow diagram, or data chart from a paper, study notes or experimental records, especially when editable source files and element-to-source traceability are required.

paper-to-academic-ppt

Turn a research paper (PDF) into a structured, evidence-traceable, template-compliant academic slide deck. Two phases: agent-authored narrative spine and page-level claims (each with paper locators and verbatim quotes), then scripted template adaptation that writes content into real master/layout placeholders, embeds original paper figures, checks overflow/aspect/notes, and exports a PDF preview. Handles missing conclusions, figure-trimming, layout mismatch and over-limit slide counts with explicit rules.

relationship-schematic

Generate or edit scientific entity-relationship schematics (mechanism diagrams, pathway chains, experimental workflows, structural containment) as traceable, editable SVG with verified relation semantics. Extracts an evidence-quoted entity/relation table first, renders a layered SVG from it, reads the drawing back to verify every relation type, direction and containment, then exports 300-dpi PNG and vector PDF. Use for any "draw a mechanism/workflow/relationship figure from this paper or case material" task where scientific correctness of entities, arrow directions and hierarchy matters.

slides-genedit

Generate and edit academic presentation decks from research material. Two routes: (1) generate a new deck from a paper/notes under fixed audience, duration and slide-count constraints, with per-slide claims, verbatim-number evidence mapping, speaker notes, and a rendered PDF preview; (2) source-preserving edits of an existing starting deck - inventory it, apply only the requested local changes, and prove untouched slides stayed byte-identical. Use when asked to turn research material into slides, or to modify/compress/re-audience an existing deck without breaking it.

Skills relacionados