Communitygithub.com

KaiyiHu/ResearchFigureSkill

Compilador visual científico com trava de evidências para figuras de pesquisa auditáveis.

O que é ResearchFigureSkill?

Esta skill transforma o conteúdo de um artigo científico em figuras de motivação e/ou pipeline prontas para publicação, seguindo um fluxo de trabalho rigoroso e auditável. Ela primeiro analisa o texto completo do artigo, respeitando exclusões do usuário, e extrai um resumo detalhado (paper-summary.md) com terminologia, números e restrições exatas. Em seguida, preenche templates de prompt fixos (motivation-prompt.md e/ou pipeline-prompt.md) que descrevem cada entidade visual, setas, rótulos e um contrato de layout seguro. A skill então gera as figuras em formato SVG e PNG, priorizando fidelidade ao estilo (rascunho à mão ou referência fornecida) e editabilidade, e executa uma verificação crítica rápida em cinco portões: ciência, estrutura, texto, óptica/layout e editabilidade. O resultado é um conjunto de arquivos mínimos, sem artefatos desnecessários, ideal para autores que precisam de figuras precisas, visualmente consistentes e que não introduzam alegações não suportadas pela fonte. Suporta ambientes onde a skill pode ler arquivos PDF e executar scripts Python, como Claude Code ou Cursor.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add KaiyiHu/ResearchFigureSkill

Perguntar na sua IA favorita

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

Documentação

Compilador de Figuras de Pesquisa

Versão pública do fluxo: 1.0.

Use o fluxo seguro mais curto:

conteúdo permitido do artigo
  → resolver se as figuras existentes do artigo podem ser inspecionadas
  → um resumo útil do artigo
  → template de prompt de motivação e/ou pipeline
  → figura editável + pré-visualização
  → uma verificação crítica rápida

Não crie um registro de evidências, arquivo de análise de papéis, FigureSpec, pacote de proveniência, JSON de auditoria ou pacote de revisão em várias rodadas, a menos que o usuário peça explicitamente por um.

Resolva SKILL_ROOT como o diretório que contém este arquivo.

1. Estabelecer o briefing do usuário

Mire na qualidade de comunicação esperada dos principais artigos de conferências de IA: contribuição clara em cinco segundos, alegações limitadas à fonte, texto legível para revisores, setas precisas, densidade de informação compacta, alinhamento disciplinado, cor acessível e um mestre editável. Exemplos incluem NeurIPS, ICML, ICLR, AAAI, CVPR, ACL e KDD. Este é um alvo de qualidade, não uma declaração automática de conformidade com o veículo. Se os requisitos técnicos atuais de um veículo específico forem importantes, verifique-os em fontes oficiais.

Peça ao usuário que forneça estas três decisões antes da análise:

Tipo de figura: Motivação, Pipeline ou ambos?
Figura correspondente existente no artigo: sim, não ou desconhecido?
Se sim: substituí-la completamente, usá-la como referência e melhorá-la, ou
preservá-la e reparar partes selecionadas?

Se a solicitação já responder a uma decisão, não a pergunte novamente. Se uma ou mais decisões estiverem faltando, faça uma pergunta concisa combinada antes de gerar. O usuário pode responder desconhecido para figuras existentes; resolva esse caso na etapa 3 sem inspecionar visualmente a figura primeiro.

2. Selecionar saídas sem classificação de papéis

Esta Skill tem dois tipos fixos de figuras:

  • motivação: por que o problema é importante e por que a pesquisa é necessária;
  • pipeline: como o método proposto transforma entrada em saída.

Siga o comando do usuário:

  • Se o usuário solicitar motivação, Figura 1, problema/lacuna, ou 动机图, gere apenas motivação.
  • Se o usuário solicitar pipeline, método, fluxo de trabalho, arquitetura, 方法图, ou 流程图, gere apenas pipeline.
  • Se o usuário solicitar ambos ou um conjunto completo de figuras, gere ambos.
  • Se o usuário não especificar um tipo, pergunte se ele deseja Motivação, Pipeline ou ambos antes de continuar.

Não infira um "papel vencedor" e suprima o outro.

3. Resolver figuras existentes do artigo antes de inspecioná-las

Respeite primeiro as exclusões do usuário. Nunca use páginas, figuras, legendas ou suplementos excluídos, mesmo para decidir se devem se tornar referências.

Para a fonte permitida restante, detecte a presença provável de uma figura de motivação ou pipeline existente sem inspecioná-la visualmente primeiro. Use sinais não visuais quando prático, como contagens de objetos de imagem em PDF, posicionamento na seção ou um marcador de Figura visível no texto extraído já permitido.

Se o artigo parecer conter uma figura existente de um tipo selecionado e o usuário já não tiver dado uma instrução, pause antes de abrir essa figura ou ler sua legenda e faça uma pergunta concisa:

O artigo parece conter uma figura de Motivação/Pipeline existente. Devo
(1) regenerar independentemente e ignorá-la, (2) usá-la apenas como referência visual/layout, ou (3) preservá-la e repará-la?
  • Para regeneração independente, não inspecione ou use a figura antiga ou sua legenda. Construa uma nova composição a partir do texto permitido do artigo e desta Skill.
  • Para regeneração orientada por referência, inspecione-a apenas após permissão e trate-a como estrutura/estilo visual, nunca como evidência científica.
  • Para reparo, preserve elementos verificados e altere apenas as partes solicitadas ou com falha.

Se o usuário já disser para descartar, ignorar, referenciar ou reparar uma figura existente, siga essa instrução sem perguntar novamente. Não pergunte sobre gráficos incidentais ou figuras não relacionadas ao tipo de saída selecionado.

4. Ler e resumir a fonte permitida

Leia o artigo ou briefing permitido completo uma vez. Respeite todas as exclusões do usuário antes da extração de texto ou inspeção visual. Nunca use legendas, figuras, páginas ou suplementos excluídos como evidência.

Crie um paper-summary.md, normalmente de 500 a 900 palavras ou equivalente, contendo:

  1. problema de pesquisa e importância;
  2. abordagem atual e lacuna concreta;
  3. tese e contribuições limitadas;
  4. entrada do método, 3–7 estágios principais, transferências e saída;
  5. resultados exatos mais fortes que ajudam a entender o artigo;
  6. limitações e interpretações que a figura não deve implicar;
  7. terminologia, números e rótulos exatos com probabilidade de aparecer em uma figura;
  8. escopo inspecionado, exclusões e material ausente.

Use âncoras de página/seção quando prático, mas não crie um registro de evidências separado. Preserve unidades, sinais, qualificadores e incerteza. Não invente módulos, valores, relações ou alegações causais ausentes.

5. Preencher o template de prompt fixo

Leia references/prompt-templates.md toda vez. Preencha apenas o template ou templates selecionados na etapa 2.

Para cada prompt:

  • substitua cada {{PLACEHOLDER}};
  • copie os rótulos científicos exatos do resumo;
  • mantenha uma mensagem clara de cinco segundos;
  • liste cada entidade visível e cada seta como fonte → destino | rótulo/payload;
  • declare o que não deve ser mostrado;
  • solicite texto editável ao vivo e formas vetoriais/nativas;
  • inclua o prompt negativo curto e a lista de verificação crítica de QA.

Salve motivation-prompt.md, pipeline-prompt.md, ou ambos. Não cole o artigo inteiro em um prompt de desenho.

Todo prompt preenchido deve incluir um contrato de segurança de layout:

  • reserve uma área segura externa limpa de 4–6% em cada borda do canvas;
  • mantenha títulos, rótulos, pontas de seta, bordas e ícones significativos completamente dentro dessa área segura; apenas texturas de fundo não essenciais podem entrar nela;
  • distribua a massa visual pelo canvas útil, normalmente ocupando 75–88% sem uma grande região em branco acidental;
  • alinhe bordas de painéis relacionados, recuos de títulos, centros de estágios, linhas de base de linhas e objetos repetidos a guias compartilhadas explícitas;
  • mantenha espaçamentos consistentes e torne os espaços em branco intencionais;
  • evite aglomeração nas bordas e uma composição com a maior parte do conteúdo comprimido em um canto.

Contrato de estilo orientado por referência

Quando o usuário fornecer um ou mais exemplos desejados, trate cada um como uma referência primária de estilo e composição, não como inspiração opcional e não como evidência científica.

Antes de renderizar, traduza os exemplos em instruções observáveis para:

  • topologia do painel e proporções de região aproximadas;
  • estilo de borda, traçado e tratamento de cantos;
  • letreiramento de títulos, letreiramento de corpo e hierarquia tipográfica;
  • família de ícones, ritmo de setas, densidade de informação e espaços em branco;
  • cores de destaque semântico e onde preenchimentos são ou não usados.

O prompt preenchido deve dizer explicitamente que o renderizador deve preservar essa linguagem visual e não deve redesenhar em um estilo genérico. Substitua todo conteúdo científico específico da referência, texto, números, logotipos e ícones únicos pelo inventário validado do artigo atual.

Se nenhuma referência visual for fornecida, use como padrão um infográfico acadêmico desenhado à mão: fundo de papel branco, linhas pretas ligeiramente irregulares, bordas de painel tracejadas coloridas e arredondadas, cabeçalhos com aparência de escrita à mão, ícones científicos doodle simples, destaques claros esparsos e densidade de informação compacta mas legível. Não use como padrão uma grade moderna de cartão corporativo.

Limite da motivação

Use:

status quo → limitação observada ou ponto cego → necessidade de pesquisa limitada

Mostre no máximo três mensagens primárias. Não revele a arquitetura completa, procedimento de treinamento ou tabela de classificação de resultados.

Limite do pipeline

Use:

entrada tipada → 3–7 estágios liderados por verbos → saída tipada

Nomeie cada transferência. Mostre ramificações ou feedback apenas quando a fonte explicitamente os suportar. Não adicione emblemas de vitória de benchmark ou módulos decorativos.

6. Gerar a figura

Use o prompt preenchido como entrada do renderizador. Não o reinterprete silenciosamente em um sistema visual diferente.

6.1 Escolher a ordem de renderização

Use renderização imagem-primeiro quando qualquer um destes for verdadeiro:

  • o usuário forneceu uma referência visual;
  • o usuário solicita geração GPT/modelo de imagem;
  • corresponder a uma linguagem visual desenhada à mão ou ilustrativa é mais importante do que pureza vetorial perfeita.

No modo imagem-primeiro, passe o prompt preenchido e a(s) imagem(ns) de referência fornecida(s) diretamente para o gerador de imagem. O primeiro artefato é o PNG fiel ao estilo. Não substitua esta etapa por um SVG corporativo desenhado manualmente.

Use renderização vetor-primeiro apenas quando o usuário priorizar explicitamente um mestre determinístico totalmente editável, ou quando gráficos/equações exatos dominarem. A saída vetor-primeiro ainda deve implementar o contrato de estilo declarado; editável não significa cartões sem serifa limpos.

Quando tanto fidelidade de estilo quanto editabilidade forem solicitadas:

  1. gere e aprove a imagem fiel ao estilo primeiro;
  2. crie um companheiro SVG editável que preserve a mesma topologia de painel, bordas tracejadas, caráter de linha desenhada à mão, hierarquia de letreiramento, ícones e paleta de destaque;
  3. mantenha os rótulos, valores e setas científicas exatas ao vivo e corretos;
  4. divulgue se qualquer camada ilustrativa permanece raster em vez de alegar que a figura inteira é totalmente editável.

Os entregáveis padrão permanecem:

motivation.svg + motivation.png
pipeline.svg + pipeline.png

Use outro formato editável apenas quando o usuário solicitar. Gráficos quantitativos exatos, eixos, equações e números sensíveis permanecem determinísticos. Rótulos de diagrama curtos podem ser gerados na passagem de estilo imagem-primeiro, mas devem ser verificados caractere por caractere e corrigidos no companheiro editável quando necessário.

Antes de renderizar, converta o contrato de segurança de layout em coordenadas ou proporções concretas. Para um canvas provisório de 1800 × 1000, mantenha o conteúdo crítico a cerca de 72–108 px das bordas esquerda/direita e 40–60 px do topo/base. Alinhe regiões e objetos repetidos a guias nomeadas. Não use bordas aparentemente sangradas que corram o risco de serem cortadas após a exportação.

Quando uma imagem de referência for fornecida, preserve sua gramática visual observável de forma suficientemente próxima para que o resultado pertença à família de estilo solicitada. Não copie seu conteúdo científico, texto, valores, logotipos ou símbolos específicos da fonte.

7. Executar uma verificação crítica rápida

Inspecione a pré-visualização real em 100% e uma visão de 200%. Verifique apenas estes portões:

  1. Ciência — nenhuma alegação, valor, componente ou conclusão legal/clínica inventada ou mais forte que a fonte.
  2. Estrutura — as entidades necessárias estão presentes; a ordem dos estágios e cada ponto final/direção da seta estão corretos.
  3. Texto — ortografia, símbolos e números exatos; sem pseudo-texto, glifos ausentes ou rótulos ilegíveis.
  4. Óptica e layout — sem desfoque, formas borradas/derretidas, sobreposição, recorte, conteúdo fora do canvas ou ampliação de baixa resolução óbvia. Confirme uma área segura de perímetro visível de 4–6%, uso balanceado do canvas, sem grande região em branco acidental, espaçamentos consistentes e alinhamento de títulos, painéis, linhas, estágios e objetos repetidos relacionados.
  5. Editabilidade — o mestre retém texto ao vivo e objetos vetoriais/nativos separados em vez de um bitmap achatado.

Quando uma referência foi fornecida, o portão de óptica também falha se a topologia do painel, tratamento de borda, caráter do letreiramento, linguagem do ícone ou densidade de informação tiverem migrado para uma família de estilo visivelmente diferente.

Para SVG, execute opcionalmente a verificação leve:

python3 "${SKILL_ROOT}/scripts/quick_qa.py" figure.svg figure.png

Para um híbrido imagem-primeiro honestamente divulgado cuja camada de ilustração permanece raster, use --allow-hybrid. Nunca use este sinalizador para descrever uma imagem achatada como totalmente editável.

Se algum portão falhar, faça um reparo direcionado e inspecione novamente. Pare no primeiro resultado aprovado. Use no máximo duas tentativas de renderização, a menos que o usuário solicite mais iteração.

8. Manter a entrega pequena

Arquivos padrão:

paper-summary.md
motivation-prompt.md        # apenas quando selecionado
motivation.svg
motivation.png
pipeline-prompt.md          # apenas quando selecionado
pipeline.svg
pipeline.png

Relate os cinco portões de QA na resposta final; não crie um arquivo de QA. Renderizações temporárias pertencem a um diretório temporário do SO e devem ser removidas após os arquivos finais passarem.

Limites

  • Não exponha material privado ou não publicado a um provedor externo sem autorização.
  • Não use eixos, valores de benchmark, equações ou rótulos científicos finais de alto risco gerados por imagem sem verificação determinística.
  • Não alegue conformidade com o veículo a menos que os requisitos oficiais atuais tenham sido verificados.
  • Não imite um artista vivo ou copie de perto uma figura de referência.
  • Não substitua a revisão especializada científica, estatística, clínica ou legal.

Habilidades Relacionadas