CommunityImagemgithub.com

Reconstrução e Desenho de Figuras Científicas

Compreende uma referência ou descrição científica e redesenha como objetos SVG limpos e independentemente editáveis. Usa a visão e raciocínio do host chamador com ferramentas determinísticas de geometria/render/edição; nenhuma API de modelo adicional ou GUI é necessária.

O que é Reconstrução e Desenho de Figuras Científicas?

Esta skill permite que um host (como Claude Code, Cursor ou Codex) reconstrua figuras científicas a partir de referências visuais ou descrições textuais, gerando arquivos SVG limpos e editáveis, além de uma prévia em PNG renderizada a partir do SVG. Utiliza o ambiente Anaconda `ScientificFigure_skill` e a ferramenta `figure-cli` para executar comandos de desenho, visualização e exportação. A skill oferece suporte a modos autônomo e interativo, com um fluxo de trabalho que começa pela compreensão da referência, seleção de método de construção, desenho da geometria, inspeção visual e correção (com no máximo três rodadas). É independente de provedor, ou seja, não depende de APIs de terceiros para funcionar, e inclui verificações de layout, fontes e qualidade (QA) para garantir figuras precisas e estruturalmente claras.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/w1-23/scientific-figure/tree/HEAD

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 Reconstrução e Desenho de Figuras Científicas faz?

Uma skill independente e neutra em relação ao provedor. O host chamador decide o que desenhar; o motor executa geometria, pinturas, camadas, edições e exportações declaradas. Entregue SVG mais um PNG renderizado a partir desse SVG. Use o Anaconda ScientificFigure_skill e o figure-cli instalado.

Guia 0.10: duas tarefas, um host e Scene

O Engine 0.10.0 atual adiciona QA de layout determinístico (layout-audit), reparos de layout limitados (--fix) e uma verificação prévia de perfil de fonte sobre o 0.9. O FigurePlan 0.1 e Scene 0.3 permanecem inalterados, e a base de execução, edição e renderização 0.8 é preservada. O host chamador já é o modelo que faz a interpretação e revisão visual; não adicione um segundo modelo ou Agente. Veja o plano 0.10 e o contrato de QA; o plano 0.9, as capacidades 0.8 e o planejamento semântico / novo fluxo de CLI continuam atuais para tudo abaixo. A página de fluxo de trabalho define os pontos de entrada implementados e os contratos exatos de arquivo; as notas de entrega registram a verificação real e os limites.

Escolha o guia de tarefa antes de construir uma figura complexa:

  • Reconstrução de referência: leia reconstrução-de-referência. Estabeleça a estrutura da informação e ordem de leitura, partes essenciais, relações e incógnitas específicas antes da geometria. Separe entidades, setas de processo, líderes de anotação, visões ampliadas, legendas e decoração. Não preencha regiões ilegíveis com conhecimento do tópico.
  • Design em linguagem natural: leia design-de-texto. Separe conteúdo explícito do usuário, escolhas de design e suposições científicas. Projete a hierarquia em torno do mecanismo solicitado; não invente preparação, administração ou condições experimentais.
  • Ambas as tarefas: use seleção-de-construção quando o método for incerto. Escolha pela forma, partes, repetição, furos, oclusão e estilo necessários, depois compare os recursos reais disponíveis. Um objeto plano simples pode ir direto de uma nota curta de intenção/desconhecida para geometria e pré-visualização; nenhuma busca ou múltiplos arquivos de planejamento são obrigatórios.

Trabalhe autonomamente por padrão; pause apenas quando solicitado

ModoIniciar quandoComportamento do host
autônomo (padrão)o usuário pede a figura ou diz para finalizá-ladesenhar, inspecionar, corrigir e entregar; não pausar para aprovação a cada etapa
interativoo usuário pede para ver uma amostra, confirmar cada página ou participarpublicar o checkpoint acordado e aguardar feedback ou aprovação
  • Abrir uma página de revisão não força uma pausa. No modo autônomo, leia novos feedbacks no próximo checkpoint seguro; se o usuário pedir para parar, pare de publicar candidatos e processe as edições deles primeiro.
  • No modo interativo, termine e publique a primeira página acordada, espere, depois continue. Para trabalho com várias páginas, a primeira página aprovada fixa tipografia compartilhada, espaçamento, estilo de cartão e regras de paleta; páginas posteriores compartilham essas regras, não um layout idêntico forçado.
  • Um host que não pode ler imagens pode usar geometria e verificações estruturais, mas deve deixar a revisão visual como não_executada.
  • Aprovar uma versão do SVG não é revisão científica e não aprova uma versão posterior.

Padrão: entender, selecionar, construir, inspecionar, corrigir

  1. Declare propósito, tamanho de exibição pretendido, módulos e ordem de leitura. Liste objetos, partes internas indispensáveis, unidades editáveis, rótulos, significados de cores e relações. Mantenha o conteúdo não resolvido explícito. Para uma figura complexa, torne este rascunho inspecionável antes de escrever geometria extensa. Use módulos/objetos/relações do FigurePlan existentes onde for útil; construções não selecionadas podem permanecer não_resolvidas. Estes são estágios de uma entrada de planejamento, não outra árvore Scene.
  2. Pergunte apenas as questões locais que afetam uma decisão: por exemplo, se uma área pálida é uma abertura ou uma superfície, ou onde termina um líder. Inspecione a original e os recortes relevantes; use evidências limitadas à fonte apenas quando necessário. Preserve ROI e mapeamentos de coordenadas. Medidas e pontuações de similaridade são observações, não identidades de objetos ou confiança científica; não há OCR implícito.
  3. Escolha receita/ativo/direto/programa por estrutura e estilo. Verifique parâmetros reais da Receita e chaves de partes editáveis ou direitos de ativo e limites de importação. O catálogo tem 15 famílias de Receitas, duas entradas de metadados de família de símbolos e um ativo de limão Twemoji; não invente Receitas de rato/frasco/avatar. Se uma Receita omitir partes necessárias, rejeite essa construção e recorra a um programa livre, opcionalmente combinando subpartes adequadas. Use coordenadas locais, curvas, transformações, funções de desenho existentes e bibliotecas maduras. Direct Scene, plano semântico legado 0.3 e SceneBuilder permanecem válidos; não exija um grande JSON manual antes de desenhar.
  4. Construa a estrutura principal e os internos necessários primeiro, depois conectores e rótulos. Preserve IDs estáveis de objeto/parte. Use superfícies preenchidas, traços, furos reais, máscaras/oclusão limitadas, repetição e gradientes conforme apropriado; não adicione iluminação volumétrica a arte plana. O host executa explicitamente programas através de ferramentas comuns e fornece fragmentos de Scene gerados; a verificação/compilação e carregamento de projeto não executam código fonte salvo. Mantenha novos candidatos separados de um projeto editado e use mesclagem B/U/C antes da aceitação.
  5. Leia o preview.png real no tamanho de exibição pretendido e inspecione regiões ampliadas chave. Verifique módulos e conexões → silhueta/proporções/furos → estrutura interna necessária → cores/camadas → texto. Compare a referência na mesma escala; ao substituir um desenho anterior, compare referência/antigo/novo juntos. Um plano válido, nome de caminho ou teste aprovado não pode estabelecer que a estrutura pretendida foi desenhada corretamente.
  6. Vincule cada descoberta a um ID e uma ação concreta: mude o método de construção, substitua um candidato, ajuste geometria/parâmetros, obtenha evidência local ou mantenha incerteza. Corrija contra a revisão atual ou regere um candidato e mescle; renderize e inspecione novamente. Padrão de no máximo três rodadas de correção direcionadas. Preserve objetos aceitos e edições do usuário. Vincule a avaliação visual à atual Scene/pré-visualização; geometria, recursos ou renderização alterados expiram avaliações antigas. Relate omissões e revisões não executadas. A revisão científica permanece separada e não executada quando não solicitada.

Sucesso significa uma figura bem desenhada e estruturalmente clara com partes principais independentemente editáveis. Testes estabelecem comportamento de engenharia, não qualidade de desenho. Ablações de host independente, campanhas de benchmark retidas, painéis humanos, certificação de domínio, integração em tempo de execução, migração de modelo entre versões e desenvolvimento experimental de deslocamento/largura variável estão fora do escopo atual de trabalho. Não os transforme em pré-requisitos ou tarefas seguintes não solicitadas. Relate o reúso real separadamente como arte externa, reúso de código de desenho e reúso de biblioteca de geometria/renderização; ter um ativo no Registro não significa que este desenho o usou.

O host pode escrever programas de desenho em Python ou JavaScript. Use variáveis comuns, funções, coordenadas locais, transformações, repetição e bibliotecas de geometria maduras para calcular formas; use ajudantes estáveis do motor quando disponíveis. Um programa de desenho específico para figura é permitido; não transforme algumas figuras de referência em algoritmos de motor específicos de tópico ou trate planos de exemplo como uma biblioteca de modelo científico. Envie candidatos de Scene/Plano gerados através de validação do motor, renderização e transações de projeto. Ao executar novamente contra um projeto editado, compare a última linha de base gerada, a Scene atual e o novo candidato antes de aceitar mudanças; preserve edições do usuário e reporte conflitos. Use os ajudantes de construção e o protocolo de geração disponíveis: generation diff PROJECT --candidate SOURCE --output DIFF, inspecione a pré-visualização e conflitos propostos, depois generation accept PROJECT --candidate DIFF --base-revision N. Código fonte salvo é inerte; aceitar recalcula a mesclagem e verifica revisão/conteúdo/recibo atuais. Nunca sobrescreva um projeto editado com saída de script puro. Não incorpore imagens raster, transforme cada textura em minúsculos caminhos ou substitua estrutura ausente por um preenchimento atrativo.

Escolha entre reconstrução a partir da referência fornecida e reúso permitido de recursos antes de desenhar. Divulgue separadamente: arte externa (fonte, licença, versão/hash e modificações); código de desenho reutilizado, incluindo suas próprias funções (arquivo/versão, partes reutilizadas e alterações); e bibliotecas de geometria/renderização (biblioteca/versão real e papel). Uma função escrita localmente não é um ativo externo, e uma chamada de biblioteca não é arte emprestada. Registre inspiração de método separadamente de código copiado; código externo copiado precisa de sua revisão de fonte fixa, arquivos, licença e avisos. Para uma comparação raster explicitamente congelada, nunca substitua um SVG oficial de fonte. Inspecione estrutura principal, geometria/furos/oclusão, depois estilo/texto em pré-visualizações reais dentro do mesmo orçamento de correção. Remendos de cobertura coloridos de fundo não estabelecem furos reais ou entrelaçamento editável. Fontes de programa são entradas de reprodutibilidade; a Scene aceita é a única autoridade editável atual. Abrir um projeto ou pacote não deve executar um programa de desenho.

Execute com arquivos, sem serviço de modelo

conda run -n ScientificFigure_skill figure-cli doctor --json

Use inspect reference.png para tamanho/hash da fonte. Planos vinculados à fonte declaram SHA-256, tamanho e ROI. A execução semântica do Plano 0.3 legado não executa implicitamente segmentação de cor, busca de candidato pixel ou análise de esqueleto. Entradas de Plano 0.1/0.2 antigas mantêm seu comportamento.

conda run -n ScientificFigure_skill figure-cli reconstruct reference.png --plan plan.json --output work/figure

Loop de pré-visualização e tempos de estágio

draw e reconstruct aceitam --preview: ele escreve apenas figure.svg, preview.png e preview.json, renderiza na escala 1 a menos que --scale diga o contrário, e pode substituir sua própria pré-visualização anterior. Não é um projeto ou uma entrega — sem recibo, manifesto de objeto, registro de QA, vínculo de revisão ou comparação de referência — então use-o para a primeira olhada e para cada rodada de correção, depois execute o mesmo comando sem --preview uma vez que a estrutura esteja correta.

conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview

Ambos os caminhos retornam tempos em segundos: validar, para_svg, renderizar, inventário, qa, publicar, total; uma pré-visualização omite os estágios de entrega e o recibo registra os mesmos estágios pré-publicação. Neste host, uma Scene de 501 objetos leva cerca de 0,33 s como pré-visualização e 1,16 s como projeto completo, a maior parte da diferença sendo renderização PNG na escala 1 versus 3. O motor não pode ver o tempo do lado do modelo: ao medir uma reconstrução, registre a primeira inferência do host, tokens de saída e rodadas de correção junto com estes números, e nunca atribua segundos do motor à latência do modelo ou vice-versa.

Verifique texto e fontes antes da construção complexa

Colete cada string que a figura desenhará — rótulos, fórmulas, unidades, texto de eixos, legendas — em uma solicitação e execute isto antes da geometria:

{"schema_version": "0.1", "texts": ["Membrana celular", "H₂O → O₂", "细胞膜"]}
conda run -n ScientificFigure_skill figure-cli font-probe texts.json --output work/fonts

status: ok seleciona uma fonte local real e escreve font-probe.json mais font-probe-sample.png; needs_input lista caracteres ausentes e cobertura por face. --font PATH adiciona um arquivo específico. --profile (nome padrão scientific-default) adicionalmente resolve a recomendação empacotada (Times New Roman / Microsoft YaHei / Cambria Math) contra fontes instaladas e reporta o caminho, face, digest e caracteres de amostra ausentes de cada papel; uma família que está ausente é reportada como ausente, nunca substituída. O motor renderiza uma família, então não reivindique fallback de fonte mista: defina SCIENTIFIC_FIGURE_FONT para o caminho selecionado você mesmo, ou simplifique o texto. Para várias páginas, teste a união de todas as páginas uma vez, antes da página 1. Um glifo ausente é uma decisão de construção, não um erro de exportação de última hora.

Mostre a figura enquanto você desenha

conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
conda run -n ScientificFigure_skill figure-cli review-serve work/quick --open
conda run -n ScientificFigure_skill figure-cli review-status work/quick-review

review-serve serve o figure.svg mais recente publicado com sucesso em 127.0.0.1 com um token aleatório e imprime a URL antes de bloquear. A página mantém zoom, pan e pins não enviados entre recarregamentos, e permite que o usuário fixe um comentário a um ID de objeto ou espaço vazio. review-status lê o log de feedback. Adicione --wait --timeout N para bloquear até que uma nova rodada chegue; sem ele, pare com Ctrl-C. O servidor apenas lê a figura e escreve feedback; nunca edita o projeto.

O feedback é armazenado em <preview>-review/feedback.json, fora do diretório de pré-visualização substituível, e cada submissão está vinculada ao SHA256 do SVG e revisão que foram mostrados. Uma submissão de uma versão mais antiga é rejeitada com HTTP 409, nunca aplicada silenciosamente. Aplique comentários aceitos através de um patch normal ou mesclagem de geração, depois publique uma nova pré-visualização. A página local é um fallback de navegador; não cria uma barra lateral do VS Code, e um host incorporado ainda deve tratar o feedback como este arquivo versionado.

Entregue SVGs somente gráficos e finais

conda run -n ScientificFigure_skill figure-cli export-variants work/figure --output deliverables/figure

Isso lê um projeto validado e escreve figure.final.svg mais figure.graphics.svg (sem texto) e variants.json. Ambos vêm da mesma Scene, então IDs compartilhados mantêm geometria e estilo idênticos; nada é redesenhado. Texto

Habilidades Relacionadas