CommunityImagemgithub.com

biopathway-mechanism-diagram

Construa ou edite diagramas de mecanismos/vias biológicas de nível de publicação a partir de materiais de pesquisa (PDF/texto) como uma declaração de mecanismo contestável - modelo de três camadas (entidades tipadas, arestas direcionadas tipadas com evidência textual, layout de compartimentos), SVG semântico correto, exportações PNG/PDF e um result.json rastreável e ciente de incertezas. Use para tarefas que pedem para desenhar, gerar ou editar diagramas de vias de sinalização, figuras de mecanismos, diagramas de cross-talk ou fluxogramas de vias; recusa-se a adivinhar direção de regulação e marca informações não declaradas.

O que é biopathway-mechanism-diagram?

Este skill para agentes de IA (como Claude Code) permite a criação e edição de diagramas de mecanismos biológicos de nível de publicação a partir de materiais de pesquisa (PDF ou texto), com rigor científico. Ele adota um modelo de três camadas: entidades tipadas (genes, proteínas, receptores, complexos, etc.), arestas direcionadas tipadas com evidência textual (citação literal e localização), e layout por compartimentos (extracelular, membrana, citoplasma, núcleo). Cada entidade e aresta no diagrama é rastreável a uma citação literal no material de origem, e a direção das arestas nunca é adivinhada: se a direção não é explicitamente declarada na fonte, a aresta é desenhada como não-dirigida e a incerteza é registrada. O skill produz como entregáveis um SVG editável, camadas, com IDs endereçáveis, exportações PNG/PDF e um arquivo result.json completo que rastreia todas as incertezas, fontes e o status de cada campo do contrato. Ele é ideal para tarefas que envolvem desenhar ou editar diagramas de vias de sinalização, figuras de mecanismos, cross-talk entre vias, ou fluxogramas de vias, e recusa-se a criar gráficos estatísticos, esquemas experimentais ou retoques estéticos. Ele opera sob um contrato de execução rigoroso: lê o case.json e task.md, executa um script de scaffold, extrai o modelo científico manualmente (passo a passo), valida com scripts de validação, renderiza o SVG, exporta PNG/PDF, e verifica a integridade de todas as saídas. Suporta cenários de edição, onde o modelo original é preservado e cada alteração é registrada. A qualidade final do diagrama é garantida por verificações: rastreabilidade de cada seta a uma citação, distinção visual clara entre tipos de arestas, uso explícito de bandas 'não especificado' para localizações não declaradas, rótulos sem overflow, e um result.json honesto que cobre todos os campos do contrato.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que biopathway-mechanism-diagram faz?

Uma figura de via é uma declaração de mecanismo que os leitores contestarão uma seta de cada vez. O contrato deste skill: cada entidade e cada aresta na tela remetem a uma citação literal com uma localização; a semântica da interação (ativação / inibição / ligação / modificação / transporte) é visualmente distinta e nunca confundida; qualquer coisa que a fonte não declarar (direção, localização, números) é marcada visivelmente como não declarada, não adivinhada. As entregas são um SVG editável em camadas, com IDs endereçáveis, mais exportações PNG/PDF e um result.json completo do contrato.

Quando usar / quando não usar

Use para: figuras de mecanismos, diagramas de vias de sinalização, cascatas receptor-núcleo, cross-talk entre vias, tarefas de "desenhar Figura N deste artigo", e edições em uma figura de via existente (adicionar/remover entidade ou aresta, renomear). Não use para: gráficos estatísticos (barras/boxplot/volcano), esquemas experimentais, ou retoques estéticos apenas; esses pertencem a skills adjacentes.

Contrato de execução (runtime da plataforma)

  • Entrada: /input/case.json (+ task.md). Trabalhe em /app/work; entregas em /app/output.
  • Primeira ação de toda a execução (antes de ler o case em profundidade): python scripts/scaffold_result.py --input /input/case.json --outdir /app/output Isso escreve um result.json com todos os campos do contrato de saída presentes, os não produzidos com null + motivo. Atualize-o passo a passo; nunca remova um campo do contrato.
  • Todos os scripts abaixo recebem caminhos no estilo --model/--svg e são Python 3 puro (stdlib apenas), salvo indicação. references/ é lido pelos scripts; leia os arquivos .md você mesmo antes do Passo 1.

Passo 0 - Leia o contrato e scaffold (1 requisição)

Execute o scaffold. Folheie task.md + case.json: identifique o alvo da figura (qual mecanismo, qual figura se estiver reproduzindo uma, cenário de gerar vs editar), os formatos de exportação necessários e o escopo de evidência. Registre a lista de campos do contrato que você deve preencher. Consciência de orçamento: procure terminar em 5-8 passos do modelo; os scripts fazem o trabalho pesado, você faz a ciência.

Passo 1 - Extraia o modelo de mecanismo (o núcleo científico - faça você mesmo)

Leia o material real (analise o PDF de verdade; leia arquivos, nunca presuma conteúdo a partir de rótulos). Construa /app/work/model.json conforme references/layout-conventions.md com SEU PRÓPRIO julgamento:

  1. Entidades — gene / proteína / receptor / RNA / complexo / molécula / célula / família. Aplique references/naming-rules.md: símbolos de genes em itálico e nós de genes distintos de suas proteínas (MYC vs MYC); símbolos preferidos com grafias da fonte em sinônimos; famílias vs membros; um nó por complexo declarado. Cada entidade carrega source: {loc, quote} — uma citação LITERAL e uma localização precisa o suficiente para ser reencontrada (seção/parágrafo/página/legenda da figura).
  2. Arestas — tipo do conjunto fechado em references/edge-types.json (ativação, inibição, ligação, fosforilação, ubiquitinação, regulação_transcricional, translocação, formação_de_complexo, ...). directed deve ser definido explicitamente. Nunca adivinhe direção: se a citação não tem pista direcional, defina directed: false e registre uma incerteza (references/uncertainty-policy.md). Ligação/recrutamento é não-dirigido. Regulação transcricional tem como alvo um nó de gene e precisa de um sinal.
  3. Compartimentos — extracelular / membrana / citoplasma / núcleo (+ RE, Golgi, sub-regiões de organelas se o mecanismo precisar). Entidades cuja localização não é declarada vão para a banda nao_especificado — nunca silenciosamente para o citoplasma. Receptores se ancoram na banda de membrana.
  4. Ordem — defina order conforme a posição na via (ordem topológica, não ordem textual); loops de feedback emergem naturalmente como arestas para trás.
  5. Números na tela (expressão, significância) apenas se existirem literalmente na fonte; caso contrário, deixe os mapeamentos de dados como nulls explícitos.

Ordem prática de extração: leia uma vez para o fluxo geral; segunda passagem frase por frase para entidades + citações; terceira passagem para arestas incluindo inibidores, feedback e cross-talk (eles se escondem em frases com "no entanto" / "enquanto").

Passo 2 - Valide o modelo (script)

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

Corrija todo erro E-*. E-DIR-01 (aresta dirigida sem pista direcional) é a guarda científica central: ou cite uma frase que declare direção ou rebaixe para não-dirigida + incerteza. Avisos exigem uma decisão consciente: nós de família, posicionamento de receptor, incompatibilidades sinal-vs-citação. Re-execute até ficar válido. Se o material não pode suportar um item de contrato necessário, anote isso agora (torna-se um null + motivo no Passo 5).

Passo 3 - Renderize SVG e exporte (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

Leia os avisos do relatório de renderização (limites do canvas, compartimentos desconhecidos). Olhe o PNG você mesmo; se o layout obscurecer o mecanismo (cruzamentos de arestas escondendo uma bifurcação, feedback sobre a cascata), ajuste order/posições de pin no modelo e re-renderize. O SVG é determinístico: modelo idêntico → SVG idêntico.

Passo 4 - Cenários de edição (se o case pedir edições em uma figura existente)

Reconstrua o modelo da figura alvo primeiro (Passo 1 no texto fonte da figura original), depois use edições que preservam a fonte — o modelo/SVG original é copiado em backup, cada edição é registrada no change_log do 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 "..."

Operações: adicionar/renomear/remover entidade (remove recusa quando arestas estão anexadas a menos que --cascade, e remoções em cascata são registradas como incertezas), adicionar/remover aresta, adicionar compartimento. Toda entidade/aresta adicionada REQUER --loc + --quote literais. Após edições, re-valide (automático) e re-renderize (Passo 3).

Passo 5 - Verifique e finalize result.json (script + você)

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

Isso relê o SVG e verifica a leitura reversa de nós/arestas, consistência legenda↔uso em ambas as direções, overflow de rótulo, limites do canvas, existência das exportações, e que cada null em result.json tem um motivo. Em seguida, finalize result.json você mesmo: preencha os campos do contrato (caminhos de fonte editável, exportações com backend/parâmetros, tabela_de_entidades/tabela_de_arestas com citações, base_da_legenda, fontes com versões, incertezas, resumo de verificação, status honesto). Mantenha _motivos_nao_respondidos para qualquer coisa null. A entrega parcial deve declarar seus limites em palavras claras.

Tratamento de exceções (caminhos reais, não decoração)

FalhaDetecçãoAção
PDF ilegível / sem camada de textoanálise falha ou texto vazioferramenta de renderização-pdf / ferramenta-ocr para renderizar, sinalize "camada de texto ausente" em result.json
Nome de entidade ambíguo (duas leituras)sua extraçãoescolha pelo contexto, registre alternativa + incerteza; se indecidível, null + motivo
Direção não declaradaE-DIR-01rebaixe para aresta não-dirigida (sem ponta de seta) + incerteza. NUNCA adivinhe
Compartimento desconhecidoE-CMP-01 / aviso de layoutbanda nao_especificado + nota
Dados numéricos ausentes para visuais codificados por dadosmodelo não tem números literaisdesenhe topologia, marque mapeamento null + "dados ausentes da fonte"
Overflow de rótuloverifique label_overflowencurte rótulo / divida em rótulo+sub / reordene
Canvas excede limitesaviso de renderizaçãodivida em painéis ou reduza ramos; anote
Backend de exportação ausentestatus do relatório de exportação falhoucadeia de fallback já tentada; entregue SVG, registre falha + orientação em result.json
PNG em branco/degeneradoblank_checkinvestigue relatório de renderização; re-renderize; registre
Erros de validação persistemcódigo de saída 2corrija modelo; se impossível de corrigir a partir do material, entregue o subconjunto válido + limites explícitos

Barra de qualidade (auto-verificação antes de finalizar)

  1. Um revisor poderia apontar para qualquer seta e obter sua justificativa literal da tabela embutida / modelo? (rastreabilidade)
  2. Ativação/inibição/ligação/modificação são visualmente distintas, e a legenda corresponde ao que foi desenhado — sem entradas faltando ou fantasmas?
  3. Tudo que não foi declarado está visivelmente não declarado (não-dirigido, banda não especificada, null + motivo)?
  4. Alguém consegue abrir o SVG, alterar um rótulo e re-exportar? (em camadas, com IDs endereçáveis, pilha de fontes padrão)
  5. O result.json cobre todos os campos do contrato com status honesto?

Arquivos

  • scripts/scaffold_result.py - result.json completo do contrato com null+motivo
  • scripts/validate_model.py - esquema + evidência de direção + verificações de nomenclatura
  • scripts/render_svg.py - SVG determinístico em camadas a partir de model.json
  • scripts/export_assets.py - PNG/PDF com cadeia de fallback + verificação de branco
  • scripts/apply_edit.py - edições registradas que preservam a fonte
  • scripts/verify_outputs.py - verificação de leitura reversa do pacote
  • references/edge-types.json - semântica de símbolos legível por máquina
  • references/symbol-semantics.md - gramática visual e sua fundamentação
  • references/naming-rules.md - convenções para genes/proteínas/famílias/complexos
  • references/uncertainty-policy.md - regras de rebaixamento; política de nunca adivinhar
  • references/layout-conventions.md - esquema de model.json + algoritmo de layout
  • examples/ras-mapk-case/ - um exemplo trabalhado com material real (Brown & Ried 2022)
  • README.md - documentação de uso autônomo

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.

Habilidades Relacionadas