LLLin000/dashscope-patent-flowchart

Figuras de pasos de procesos biológicos — playbook compuesto

Genera figuras independientes y precisas para pasos de procesos biológicos, de biomateriales, de ingeniería de tejidos y de laboratorio.

Límite de confianza: Solo las tarjetas de mapeo verificadas por fuente pueden introducir afirmaciones científicas. La inspección de renderizado verifica la conformidad de píxeles con la tarjeta de mapeo; no puede actualizar ni crear afirmaciones de origen. Las imágenes de estilo y referencia nunca deciden ciencia.

Estructura: átomos → moléculas → este playbook

Esta habilidad es un compuesto (playbook). No contiene el procedimiento en sí mismo — orquesta moléculas (compuestos), que encadenan explícitamente átomos (capacidades).

compounds (este playbook): elegir modo, ejecutar moléculas, mantener juicio
  └─ composites/: flujos de trabajo con ámbito, orden explícito de átomos (2-6 átomos cada uno)
       └─ capabilities/: primitivos de un solo propósito, casi deterministas

La profundidad está limitada intencionadamente a dos niveles: las moléculas llaman átomos directamente, los átomos nunca llaman a otros átomos, el playbook nunca alcanza más allá de las moléculas. Un gráfico más profundo es donde la confiabilidad del agente se desmorona.

• Átomos (capabilities/): un objetivo, un artefacto, mecánico. Sin decisiones de orquestación.
• Moléculas (composites/): una tarea con ámbito con instrucciones explícitas "llamar al átomo X, luego al átomo Y". Minimiza la toma de decisiones en tiempo de ejecución.
• Este playbook: selección de modo, ordenamiento, escalado y los invariantes que anulan todo lo demás.

Mapa de moléculas

Molécula	Archivo	Encadena átomos
analyze-project	composites/analyze-project.md	extract-source-text → analyze-entities → build-material-bible → extract-style-sheet (si hay referencia)
plan-step	composites/plan-step.md	write-mapping-card → check-mapping-card → Compuerta 1
render-step	composites/render-step.md	assemble-prompt → render-image → run-probe (iterar dentro del presupuesto)
finalize-step	composites/finalize-step.md	fit-labels (+ build-evidence-package si se solicita)

Admisión — preguntar antes de empezar

Al inicio de la tarea, aclare las opciones definidas por el usuario en una ronda con la herramienta de pregunta (ask), antes de tocar archivos:

1. Tipo de tarea — enruta el flujo de trabajo (tabla abajo).
2. Modo de tarea — quick (exploración, permanece DRAFT) o verified (entrega final).
3. Modo de Compuerta 1 — strict_verified (verificación con fuente humana) o agent_draft (sin compuerta humana).
4. Fuente — patente / artículo / protocolo / DOCX / PDF / texto pegado; ruta o archivo.
5. Imagen de referencia — proporcionada (solo estilo) o ninguna.
6. Presupuesto de iteración por paso (por defecto 5 renders).
7. Entregables — solo PNG, PNG + etiquetas, o PNG + etiquetas + paquete de evidencia.
8. Modelo — por defecto qwen-image-3.0-pro, o buscar el catálogo (capabilities/list-image-models.md, scripts/list_image_models.py) y dejar que el usuario elija; registrar la elección en model_choice.json.

No adivine opciones que el usuario pueda responder en una ronda. Reutilice respuestas anteriores al continuar un proyecto existente.

Orquestación

Tipo de tarea → enrutamiento del flujo de trabajo

Tipo de tarea	Moléculas a ejecutar	Notas
Figura de un solo paso nuevo	plan-step → render-step (+ finalize-step si es verified)	ejecutar analyze-project solo si aún no existe una biblia de proyecto
Conjunto completo de figuras (varios pasos)	analyze-project → por paso: plan-step → render-step → finalize-step	pipeline completo
Revisar un render de paso existente	solo render-step	reutilizar la tarjeta verificada; volver a ejecutar Compuerta 1 solo si la tarjeta cambia
Reetiquetar un render aceptado	finalize-step (solo fit-labels)	sin re-render
Paquete de evidencia / auditoría	finalize-step (solo build-evidence-package)	indexa artefactos existentes
Exploración de estilo / boceto	plan-step (agent_draft, mínimo) → render-step	la salida permanece DRAFT/UNVERIFIED

Modos

• quick — exploración: mapeo mínimo, agent_draft, sin compuertas humanas, sin etiquetas, sin paquete de evidencia. Salida DRAFT/UNVERIFIED.
• verified — entrega final: análisis completo, Compuerta 1 strict_verified, etiquetado, Compuerta 3, paquete de evidencia opcional.

Cada molécula termina con un artefacto nombrado y un estado de verificación; nunca omita la salida requerida de una molécula. Ante cualquier salida DRAFT/UNVERIFIED: establécela explícitamente; nunca la presentes como verificada.

Entradas requeridas

1. Fuente científica (patente / artículo / protocolo / texto DOCX / PDF o descripción del usuario) — la autoridad para operación, identidad y estado.
2. Imagen de referencia opcional (solo estilo).
3. Modo de tarea y modo de Compuerta 1.

Salidas requeridas

Por paso generado, el flujo de trabajo DEBE producir:

Archivo	Molécula	Contenido
project_material_bible.yaml	analyze-project	Análisis de Etapa 0 (una vez por proyecto)
stepN_mapping.yaml	plan-step	tarjeta de mapeo + estado de verificación
stepN_prompt.txt	render-step	prompt final textual
stepN_vXX.png + .json	render-step	un candidato por versión + metadatos
stepN_probe.yaml	render-step	resultados de sonda Compuerta 2
stepN_labeled.png	finalize-step	después de Compuerta 3 (modo verified)

Compuertas

Compuerta	Ubicación	Qué verifica
Compuerta 1	plan-step	tarjeta de mapeo ↔ fuente abierta (humano, modo estricto)
Compuerta 2	render-step	render ↔ tarjeta de mapeo (sondas fijas)
Compuerta 3	finalize-step	etiquetas ↔ píxeles enviados

Ningún otro artefacto en este flujo de trabajo es una compuerta de verdad. Todo lo demás es documentación, higiene o un sustrato ejecutable.

Invariantes requeridos

1. La fuente es autoritativa para operación, identidad, estado.
2. No se inventa ninguna operación o entidad científica para la composición.
3. Entidades repetidas: un descriptor canónico por proyecto; los tokens de identidad son estables a menos que una transición declarada justifique un desvío.
4. Las propiedades inciertas se mantienen genéricas o ABIERTAS; nunca se resuelven en silencio.
5. La biblia de estilo / imagen de referencia ≠ evidencia científica.
6. La topología proviene de la tarjeta de mapeo verificada.
7. Las etiquetas y los píxeles enviados están de acuerdo.
8. El éxito de la API ≠ aceptación visual o científica.
9. Una verificación de fuente omitida produce DRAFT/UNVERIFIED, nunca una afirmación verificada.

Estructura del repositorio

SKILL.md                  este playbook (compuesto)
composites/               moléculas
capabilities/             átomos
schemas/                  JSON Schema para biblia de material / tarjeta de mapeo / metadatos de render / sonda
adapters/                 contrato específico del renderizador (dashscope.md)
scripts/                  renderizador genérico (generate_image.py)
examples/                 artefactos trabajados (hydrogel_patent/)
.env.example              plantilla de clave; copiar a .env localmente

Extensión

• Nueva operación de un solo propósito → agregar un capabilities/*.md, mantenerlo mecánico, darle un esquema o script si toca uno.
• Nueva tarea con ámbito → agregar un composites/*.md que encadene átomos existentes; preferir reutilizar átomos sobre crear nuevos.
• Nuevo trabajo de alto nivel → componer moléculas en este playbook (o en un nuevo playbook).
• Una capacidad que llama a otra capacidad es una molécula por definición; no profundices la capa de átomos.