Communitygithub.com

joshua-zyy/academic-paper-writer

Skill de redação acadêmica orientada por evidências, por seções, para as áreas de Ciência da Computação, IA e Aprendizado de Máquina.

O que é academic-paper-writer?

Este skill foca na geração e ilustração de figuras acadêmicas para artigos nas áreas de CS/AI/ML. Ele é projetado para criar gráficos de dados experimentais no formato SVG editável (Python/matplotlib), seguindo rigorosamente um 'gate de design' específico para CS/AI/ML. O skill é baseado em um protocolo de roteador que carrega regras vinculantes (stance, red-lines, output-contract, anti-patterns) e opera em quatro modos distintos: 'chart-from-data', 'figure-blueprint', 'figure-audit' e 'figure-revision'. É importante notar que diagramas de modelo, arquitetura e mecanismos complexos não são gerados automaticamente; nesses casos o skill produz apenas notas para produção manual de figuras. O skill é compatível com plataformas como Claude Code e Cursor, e utiliza um agente dedicado (figure_agent) para garantir a entrega de artefatos, scripts e relatórios de qualidade, sem modificar o código-fonte ou dados experimentais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add joshua-zyy/academic-paper-writer

Perguntar na sua IA favorita

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

Documentação

Academic Figure

Roteador de figuras acadêmicas para CS/AI/ML. Gráficos de dados experimentais são entregues por padrão como SVG editável (Python/matplotlib) e executam o gate de design de gráficos CS/AI/ML. Diagramas de modelo, arquitetura, overview e mecanismos complexos não fazem parte do escopo de desenho automático deste skill; se o artigo necessitar de tais figuras, apenas são gerados requisitos de desenho manual, lista de evidências, rascunho de legenda ou notas de blueprint.

Protocolo do Roteador

  1. Leia manifest.yaml. Ele declara arquivos always_load, axes e references.on_demand.
  2. Leia cada arquivo listado em always_load. Estas são as regras vinculantes do skill — não material de referência.
  3. Aplique o material carregado como restrições:
    • stance.md define plotagem exclusiva em Python, contrato de figura, política visual e escopo.
    • red-lines.md define proibições absolutas. Não negocie estas.
    • output-contract.md define entregáveis por modo.
    • anti-patterns.md define modos de falha conhecidos e suas alternativas corretas.
  4. Selecione exatamente um mode do manifesto. Se ambíguo, faça uma única pergunta concisa de esclarecimento apenas quando a fonte de dados ou o uso alvo estiverem faltando. Solicitações de diagramas de modelo, arquitetura, overview ou mecanismo usam figure-blueprint apenas para produzir notas manual_figure_needed; nunca renderize imagens, SVG ou prompts.
  5. Apresente o modo selecionado ao usuário antes de executar.
  6. Acesse references/ apenas quando a condição references.on_demand do manifesto for satisfeita.

Modos

ModoUsar quando
chart-from-dataArquivos de dados ou resultados numéricos, precisa de gráfico para publicação com gate de design CS/AI/ML
figure-blueprintDeseja sugestões de figuras para uma seção do artigo
figure-auditFigura existente revisada quanto à prontidão para publicação
figure-revisionFigura existente precisa de revisão

Despacho do Agente

agents/figure_agent.md é despachado pelo orquestrador no Passo 6.4. O agente retorna artefatos de figura, scripts, caminhos SVG e relatórios; não deve editar independentemente o código-fonte do projeto ou dados experimentais.

Critérios de Conclusão

  • chart-from-data: Contrato de Figura, gate de design de gráficos CS/AI/ML, script Python, dados fonte, SVG editável, relatório de QA — todos aprovados.
  • figure-audit: Cada item de QA tem status aprovado/reprovado e remediação concreta.
  • figure-blueprint: Cada figura sugerida mapeia para uma afirmação do artigo e uma fonte de dados/evidência.
  • figure-revision: Artefato revisado ou instruções, relatório de QA, rastreabilidade de evidência inalterada.

Habilidades Relacionadas