Communitygithub.com

Paper Analyst

Analisa artigos acadêmicos e PDFs de pesquisa. Use esta habilidade quando o usuário enviar ou colar um artigo de pesquisa e quiser entendê-lo.

O que é Paper Analyst?

O Paper Analyst é uma habilidade especializada para agentes de IA, como Claude Code, Cursor ou Codex, projetada para analisar artigos acadêmicos em PDF ou texto colado. Ela oferece modos flexíveis (rápido, padrão, estendido e para apresentação) que se adaptam às necessidades do usuário, desde um resumo rápido até uma análise completa com planos de slides. A habilidade prioriza a precisão e evita alucinações por meio de regras rigorosas: toda afirmação é marcada como `[原文声明]` (diretamente do artigo) ou `[模型归纳]` (inferida pelo modelo), campos incertos são explicitamente indicados com `[未明确给出]` ou `[不确定]`, e nenhum conteúdo é inventado para preencher lacunas — especialmente em PDFs de baixa qualidade. O fluxo de trabalho inclui etapas de avaliação da qualidade do PDF, classificação do tipo de artigo e execução da análise seguindo esquemas de referência. Para apresentações, o agente pode extrair figuras do PDF, planejar slides e acionar automaticamente uma habilidade pptx para gerar o arquivo, com opções para personalizar o público, duração e estilo da apresentação. É uma ferramenta essencial para pesquisadores que desejam compreender, resumir ou apresentar artigos acadêmicos de forma eficiente e confiável.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/flyer-Li/paper-analyst/tree/main

Perguntar na sua IA favorita

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

Documentação

O que Paper Analyst faz?

Analisa artigos acadêmicos de PDF ou texto colado. A saída padrão é em chinês. Todas as saídas seguem references/output-schema.md. A detecção do tipo de artigo usa references/paper-type-rubric.md. Regras anti-alucinação em references/quality-checklist.md.

Referência Rápida

ArquivoObjetivo
references/output-schema.mdEstrutura das seções e regras dos campos
references/paper-type-rubric.mdComo classificar o tipo de artigo
references/quality-checklist.mdLista de verificação anti-alucinação
references/presentation-schema.mdEsquema JSON do plano de slides
references/presentation-style-guide.mdRegras de compressão de conteúdo para slides
references/pptx-handoff.mdComo chamar a habilidade pptx para renderização
scripts/extract_pdf_meta.pyOpcional: extrair metadados do PDF para JSON

Seleção de Modo

Modo padrão: standard. Detectado a partir da solicitação do usuário:

ModoGatilhoSaída
quick"quick", "简单说", "一句话", "简要"Cabeçalho + informações + resumo + 3 contribuições
standard(padrão)Análise completa: seções 1 a 5
extended"前作", "课题组", "prior work"standard + trabalhos anteriores do autor/grupo
presentation"PPT", "组会", "汇报大纲", "slides"standard + esboço dos slides
presentation_with_figures"图表", "figures", "带图", "关键图"presentation + anotações de figuras

Se ambíguo, use standard e ofereça para mudar.

Fluxo de Trabalho

Passo 1: Avaliar a Qualidade da Entrada

Classifique a qualidade do PDF antes da análise:

  • Boa: Texto completo extraível
  • Degradada: Texto parcial, seções escaneadas, codificação distorcida
  • Severamente degradada: Texto mínimo, PDF apenas com imagens

Se degradada: indique o motivo na linha de cabeçalho, prossiga com o conteúdo disponível, marque todas as lacunas explicitamente. Nunca fabrique conteúdo para preencher lacunas.

Opcional: se o usuário tiver Python, sugira executar scripts/extract_pdf_meta.py primeiro para metadados estruturados.

Passo 2: Classificar o Tipo de Artigo

Leia references/paper-type-rubric.md e classifique. NÃO assuma IA/ML. Saída do rótulo do tipo e 2 a 3 indicadores de evidência antes de prosseguir.

Passo 3: Executar a Análise

Siga references/output-schema.md para o modo selecionado. Aplique todas as regras de references/quality-checklist.md em cada seção.

Passo 4: Autoverificação Antes da Saída

Verifique antes de finalizar:

  • Todo campo incerto marcado como [不确定] ou [未明确给出]
  • Toda contribuição marcada com [原文声明] ou [模型归纳]
  • Nenhuma seção omitida silenciosamente — seções ignoradas devem informar o motivo
  • O rótulo do tipo de artigo corresponde às evidências da rubrica

Regras Anti-Alucinação

Regras completas em references/quality-checklist.md. Restrições inegociáveis:

  1. Marcação de fonte: [原文声明] = declarado diretamente no artigo (cite a localização); [模型归纳] = inferido pelo modelo (informe a base do raciocínio)
  2. Incerteza: [未明确给出] quando ausente; [不确定] quando ambíguo
  3. Sem suposição de domínio: classifique o tipo de artigo primeiro, sempre
  4. Sem invenção: local, DOI, ano, afiliações não presentes no texto → [未明确给出]
  5. Vinculação de evidência: cada contribuição deve citar seção/figura/tabela/citação
  6. PDF degradado: informe quais seções eram ilegíveis; não preencha lacunas

Fallback para Entrada Degradada

SituaçãoAção
Apenas resumo disponívelModo quick, observe a limitação
PDF escaneado, sem textoPeça ao usuário o texto ou OCR primeiro
Seção de referências ausentePule a análise de trabalhos anteriores, observe a ausência
Figuras ilegíveisPule a análise de figuras, observe a ausência
Artigo não em inglêsTraduza seções principais, observe o idioma de origem

Modo Estendido: Trabalho Anterior do Autor

Apenas no modo extended:

  1. Extraia todos os nomes de autores do artigo
  2. Identifique autocitações na lista de referências (autores compartilhados)
  3. Infira o foco do grupo de pesquisa a partir das afiliações + título do artigo
  4. Liste trabalhos anteriores apenas da lista de referências — sem pesquisa na web, sem conhecimento externo
  5. Marque toda a saída: [基于论文内引用,非外部检索]
  6. Se informação insuficiente: declare explicitamente "信息不足,无法判断前作关系"

Modo Apresentação: Geração de PPT

Apenas no modo presentation ou presentation_with_figures.

Etapa A: Coletar Substituições

Antes de construir o plano de slides, verifique se o usuário especificou algum dos:

  • audience (laboratório / conferência / geral) — padrão: laboratório
  • duration_hint (10min / 20min / 30min) — padrão: 20min
  • talk_style (técnico / visão geral / discussão) — padrão: técnico
  • emphasis (quais seções expandir)
  • skip (quais seções omitir)

Se não especificado, use os padrões silenciosamente.

Etapa B0: Extrair Figuras do PDF (apenas presentation_with_figures)

Antes de construir o plano de slides, execute:

python scripts/extract_pdf_figures.py <pdf_path>

Isso salva todas as figuras em figures/ e escreve figures/index.json com name, path e page para cada imagem. Use este índice ao atribuir caminhos figure_ref na transferência.

Etapa B: Construir Plano de Slides

Siga references/presentation-schema.md para a estrutura. Siga references/presentation-style-guide.md para as regras de compressão.

  • Mapeie cada papel de slide para a seção correspondente do esquema de saída
  • Aplique substituições do usuário (emphasis → expandir, skip → omitir)
  • Para presentation_with_figures: defina figure_needed: true nos slides de método/resultado onde uma figura é a evidência principal; adicione figure_ref e figure_hint
  • Número de slides a partir de duration_hint (10min → 6-7, 20min → 9-10, 30min → 12-14)

Etapa C: Chamar Habilidade pptx

Siga references/pptx-handoff.md para o formato exato de transferência.

  • Remova todas as marcas [原文声明] / [模型归纳] antes de passar para pptx
  • NÃO inclua notas do apresentador na transferência
  • Chame a habilidade pptx automaticamente — não pergunte ao usuário primeiro
  • Exceção: se o usuário disser "只要大纲" / "just the outline", produza o plano de slides como texto e pule pptx

Habilidades Relacionadas