LLLin000/dashscope-patent-flowchart

Figuras de etapas de processos biológicos — playbook composto

Gere figuras autônomas e precisas para etapas de processos biológicos, de biomateriais, engenharia de tecidos e laboratoriais.

Limite de confiança: Apenas cartões de mapeamento verificados por fonte podem introduzir alegações científicas. A inspeção de renderização verifica a conformidade de pixels com o cartão de mapeamento; ela não pode atualizar ou criar alegações de fonte. Imagens de estilo e referência nunca decidem a ciência.

Estrutura: átomos → moléculas → este playbook

Esta habilidade é um composto (playbook). Ela não contém o procedimento em si — ela orquestra moléculas (compósitos), que encadeiam explicitamente átomos (capacidades).

compostos (este playbook): escolher modo, executar moléculas, manter julgamento
  └─ composites/: fluxos de trabalho com escopo, ordem explícita de átomos (2-6 átomos cada)
       └─ capabilities/: primitivas de propósito único, quase determinísticas

A profundidade é limitada a dois níveis propositalmente: moléculas chamam átomos diretamente, átomos nunca chamam outros átomos, o playbook nunca alcança além das moléculas. Um grafo mais profundo é onde a confiabilidade do agente se desfaz.

• Átomos (capabilities/): um objetivo, um artefato, mecânico. Sem julgamentos sobre orquestração.
• Moléculas (composites/): uma tarefa com escopo com instruções explícitas de "chame átomo X, depois átomo Y". Minimiza a tomada de decisão em tempo de execução.
• Este playbook: seleção de modo, ordenação, escalonamento e os invariantes que sobrepujam tudo.

Mapa de moléculas

Molécula	Arquivo	Cadeia de átomos
analyze-project	composites/analyze-project.md	extract-source-text → analyze-entities → build-material-bible → extract-style-sheet (se referência)
plan-step	composites/plan-step.md	write-mapping-card → check-mapping-card → Portão 1
render-step	composites/render-step.md	assemble-prompt → render-image → run-probe (iterar dentro do orçamento)
finalize-step	composites/finalize-step.md	fit-labels (+ build-evidence-package se solicitado)

Entrada — pergunte antes de começar

No início da tarefa, esclareça as opções definidas pelo usuário em uma rodada com a ferramenta de pergunta (ask), antes de tocar nos arquivos:

1. Tipo de tarefa — roteia o fluxo de trabalho (tabela abaixo).
2. Modo de tarefa — quick (exploração, permanece RASCUNHO) ou verified (entrega final).
3. Modo do Portão 1 — strict_verified (verificação humana da fonte) ou agent_draft (sem portão humano).
4. Fonte — patente / artigo / protocolo / DOCX / PDF / texto colado; caminho ou arquivo.
5. Imagem de referência — fornecida (apenas estilo) ou nenhuma.
6. Orçamento de iteração por etapa (padrão 5 renderizações).
7. Entregáveis — apenas PNG, PNG + rótulos, ou PNG + rótulos + pacote de evidências.
8. Modelo — padrão qwen-image-3.0-pro, ou obter o catálogo (capabilities/list-image-models.md, scripts/list_image_models.py) e deixar o usuário escolher; registrar escolha em model_choice.json.

Não adivinhe opções que o usuário pode responder em uma rodada. Reutilize respostas anteriores ao continuar um projeto existente.

Orquestração

Tipo de tarefa → roteamento do fluxo de trabalho

Tipo de tarefa	Moléculas a executar	Notas
Figura de etapa única nova	plan-step → render-step (+ finalize-step se verificado)	executar analyze-project apenas se ainda não existir uma bíblia do projeto
Conjunto completo de figuras (multi-etapa)	analyze-project → por etapa: plan-step → render-step → finalize-step	pipeline completo
Revisar uma renderização de etapa existente	apenas render-step	reutilizar o cartão verificado; reexecutar Portão 1 apenas se o cartão mudar
Reetiquetar uma renderização aceita	finalize-step (apenas fit-labels)	sem re-renderização
Pacote de evidências / auditoria	finalize-step (apenas build-evidence-package)	indexa artefatos existentes
Exploração de estilo / esboço	plan-step (agent_draft, mínimo) → render-step	saída permanece RASCUNHO/NÃO VERIFICADO

Modos

• quick — exploração: mapeamento mínimo, agent_draft, sem portões humanos, sem rótulos, sem pacote de evidências. Saída RASCUNHO/NÃO VERIFICADO.
• verified — entrega final: análise completa, Portão 1 strict_verified, rotulagem, Portão 3, pacote de evidências opcional.

Cada molécula termina com um artefato nomeado e um estado de verificação; nunca pule a saída necessária de uma molécula. Em qualquer saída RASCUNHO/NÃO VERIFICADO: declare explicitamente; nunca a apresente como verificada.

Entradas necessárias

1. Fonte científica (patente / artigo / protocolo / texto DOCX / PDF ou descrição do usuário) — a autoridade para operação, identidade e estado.
2. Imagem de referência opcional (apenas estilo).
3. Modo de tarefa e modo do Portão 1.

Saídas necessárias

Por etapa gerada, o fluxo de trabalho DEVE produzir:

Arquivo	Molécula	Conteúdo
project_material_bible.yaml	analyze-project	Análise do Estágio 0 (uma vez por projeto)
stepN_mapping.yaml	plan-step	cartão de mapeamento + status de verificação
stepN_prompt.txt	render-step	prompt final literal
stepN_vXX.png + .json	render-step	um candidato por versão + metadados
stepN_probe.yaml	render-step	resultados da sonda do Portão 2
stepN_labeled.png	finalize-step	após o Portão 3 (modo verificado)

Portões

Portão	Localização	O que verifica
Portão 1	plan-step	cartão de mapeamento ↔ fonte aberta (humano, modo estrito)
Portão 2	render-step	renderização ↔ cartão de mapeamento (sondas fixas)
Portão 3	finalize-step	rótulos ↔ pixels enviados

Nenhum outro artefato neste fluxo de trabalho é um portão de verdade. Todo o resto é documentação, higiene ou um substrato executável.

Invariantes necessários

1. Fonte é autoridade para operação, identidade, estado.
2. Nenhuma operação ou entidade científica inventada para composição.
3. Entidades repetidas: um descritor canônico por projeto; tokens de identidade estáveis a menos que uma transição declarada justifique desvio.
4. Propriedades incertas permanecem genéricas ou EM ABERTO; nunca resolvidas silenciosamente.
5. Bíblia de estilo / imagem de referência ≠ evidência científica.
6. Topologia vem do cartão de mapeamento verificado.
7. Rótulos e pixels enviados concordam.
8. Sucesso da API ≠ aceitação visual ou científica.
9. Uma verificação de fonte ignorada produz RASCUNHO/NÃO VERIFICADO, nunca uma alegação verificada.

Layout do repositório

SKILL.md                  este playbook (composto)
composites/               moléculas
capabilities/             átomos
schemas/                  JSON Schema para bíblia de material / cartão de mapeamento / metadados de renderização / sonda
adapters/                 contrato específico do renderizador (dashscope.md)
scripts/                  renderizador genérico (generate_image.py)
examples/                 artefatos trabalhados (hydrogel_patent/)
.env.example              template de chave; copie para .env localmente

Extensão

• Nova operação de propósito único → adicione um capabilities/*.md, mantenha-o mecânico, dê a ele um esquema ou script se tocar em um.
• Nova tarefa com escopo → adicione um composites/*.md que encadeie átomos existentes; prefira reutilizar átomos a criar novos.
• Novo trabalho de alto nível → componha moléculas neste playbook (ou um novo playbook).
• Uma capacidade que chama outra capacidade é por definição uma molécula; não aprofunde a camada de átomos.