schemdraw — Esquemas Científicos Editáveis com Rastreabilidade de Fonte
Caminho do script: Esta skill está instalada em
/skills/weekly-skill/, o caminho absoluto do script é/skills/weekly-skill/scripts/(o diretório de trabalho é/app/work, não use caminhos relativos).
Produza uma figura que seja correta, editável e compatível com exportação: cada entidade/relação rastreia até o material, a legenda corresponde aos dados, o texto permanece selecionável e as exportações atendem à resolução alvo. O modo de falha que esta skill existe para prevenir: uma imagem bonita com relações de entidades erradas, nomes de genes ou concentrações inventados, uma legenda que discorda dos dados e uma saída apenas bitmap que não pode ser editada.
Método em uma linha: extrair entidades/relações do material → organizá-las como um SVG em camadas (agrupado, texto selecionável, direção da seta por tipo de relação) → construir o gráfico a partir dos mesmos dados de origem com uma legenda/mapa de cores explícito → exportar PDF+PNG → validar a rastreabilidade e o contrato de exportação.
Quando usar
- Entrada: um arquivo de caso (padrão
/input/case.json) com o material científico, listas opcionais de entidades/relações, dados de gráfico e especificações de exportação. - Saída: em
/app/output—figure.svg,chart.svg,figure.pdf,figure.png,entities.json,export_report.json,validation.json,result.json. - O SVG é a fonte editável; PDF/PNG são exportações.
Pipeline (executar em ordem)
Fase 1 — Extrair e desenhar
python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
- Lê cada material (texto/Markdown), mescla as
entities/relationsfornecidas com relações extraídas de padrões:X activates|promotes|enhances Y,X inhibits|suppresses|blocks Y,X -> Y,X --| Y,X binds|interacts with Y,X contains|includes Y. - Cada relação carrega
provenance(text-pattern+ a citação fonte) ou vem da lista fornecida. - Escreve
entities.jsone umfigure.svgem camadas:<g id="arrows">comdata-source/data-target/data-type,<g id="nodes">com um grupo por entidade e rótulos<text>. A cor/traçado da seta codifica o tipo de relação (verde = ativação, vermelho = inibição, tracejado = contenção). - Se o caso tem dados de gráfico, escreve
chart.svgcujas barras carregamdata-label/data-valuee cuja legenda usa o mesmo índice de paleta das barras.
Fase 2 — Exportar
python3 /skills/weekly-skill/scripts/export.py --work /app/work --dpi 300
LibreOffice headless converte SVG → PDF (vetorial, texto selecionável); PyMuPDF rasteriza PDF → PNG na DPI solicitada. Escreve export_report.json. Se o LibreOffice estiver ausente, o relatório informa e o status se torna partial — nunca uma falha silenciosa.
Fase 3 — Validar
python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
Verifica:
- cada ponto final de relação é uma entidade declarada (sem setas soltas);
- cada relação tem proveniência ou uma citação fonte;
- rótulos e valores da legenda do gráfico correspondem exatamente aos dados de origem;
- o SVG tem
<text>(selecionável) e ≥2 camadas; - as exportações PDF e PNG existem e o PNG não é suspeitamente pequeno.
Fase 4 — Copiar entregáveis
mkdir -p /app/output
cp /app/work/figure.svg /app/work/chart.svg /app/work/figure.pdf /app/work/figure.png \
/app/work/entities.json /app/work/export_report.json /app/work/result.json /app/output/
# validation.json é escrito por validate.py; copie-o também se presente
Regras que devem ser mantidas
- Entidades vêm do material. Nenhum nome de gene, concentração ou ponto de tempo inventado; qualquer coisa que o modelo adicionar deve ser referenciada e marcada.
- Direção da relação é dado.
A activates Bé desenhado A → B, nunca invertido; o tipo de seta segue o tipo de relação. - Legenda ⇄ consistência dos dados. Rótulos e cores da legenda vêm do mesmo array que as barras; alterar os dados altera a legenda.
- Fonte editável + exportação conforme. Sempre entregar o SVG (editável) e o PDF/PNG (exportação) juntos.
- Exportação é verificada, não presumida. DPI, incorporação de fonte e existência de arquivo são registrados; uma exportação falha é reportada.
Tratamento de exceções
| Situação | Comportamento |
|---|---|
| Sem material / vazio | lista de entidades vazia; SVG ainda escrito com um título |
| Ponto final de relação desconhecido | mantido em entities (adicionado a partir do padrão) e desenhado |
| Dados de gráfico ausentes | chart.svg ignorado; entities.json.chart_svg = null |
| LibreOffice ausente | PDF/PNG ausentes, export_report.status = partial, limitação registrada |
| Sem relações | SVG apenas com nós; validação anota 0 relações |
Autoverificação
python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
python3 -c "import json;e=json.load(open('/app/work/entities.json'));print(len(e['entities']), len(e['relations']), e['relation_counts'])"
valid: true é obrigatório; o modelo deve preencher qualquer entidade/relação que o extrator determinístico perdeu, sempre com uma fonte.