Alitaliy/summarize-paper-skill

Resumir Artigo Acadêmico

Visão Geral

Use esta habilidade para resumir um artigo acadêmico a partir da fonte fornecida pelo usuário. Extraia o propósito do artigo, principais contribuições, técnicas, limitações e perspectivas futuras, e produza tanto um resumo em Markdown quanto uma pasta de trabalho do Excel quando o ambiente puder criar arquivos.

Regras Fundamentais

• Baseie cada afirmação factual no artigo fornecido. Não adicione contexto externo, intenção do autor, alegações de impacto ou contexto de área, a menos que o usuário peça explicitamente.
• Separe o conteúdo declarado no artigo da inferência. Marque cada item como 原文明确, 原文概括, 合理推测, ou 未提及.
• Use 合理推测 apenas quando o artigo não afirmar diretamente o item, mas a inferência decorrer de métodos, resultados, limitações ou texto de conclusão próximos.
• Mantenha uma linguagem cautelosa nas inferências, usando frases como 可推测, 可能, 倾向于说明, ou 未来可进一步.
• Não interprete em excesso. Se as evidências forem fracas, marque o item como 未提及 ou explique a incerteza na coluna de evidências.
• Preserve detalhes importantes que o artigo realmente afirma, incluindo configuração da tarefa, conjunto de dados, modelo/estrutura, configuração experimental, métricas de avaliação e técnicas nomeadas, quando relevantes.
• Use referências curtas de evidências em vez de citações longas. Prefira âncoras de página, seção, tabela, figura ou parágrafo quando disponíveis.
• Se o texto do artigo estiver incompleto, digitalizado ou com qualidade de extração ruim, declare essa limitação antes do resumo e evite preencher lacunas com afirmações confiantes.
• No Markdown voltado para o usuário, agrupe o conteúdo pelas seis dimensões obrigatórias e apresente múltiplas afirmações como marcadores sob a mesma dimensão. Não apresente 研究目的, 主要贡献 ou outras dimensões repetidas como seções visuais separadas.
• Mantenha as linhas estruturadas do JSON/Excel no nível de reivindicação para rastreabilidade, mas garanta que as linhas sejam ordenadas por dimensão para que as páginas downstream possam agrupá-las de forma limpa.

Fluxo de Trabalho

1. Identifique o tipo de fonte do artigo: PDF, DOCX, Markdown, texto puro, trecho colado ou texto extraído.
2. Leia primeiro o resumo, introdução, método, experimentos/resultados, discussão, limitações e conclusão.
3. Examine o restante do corpo em busca de afirmações que afetem as categorias obrigatórias.
4. Construa uma lista de afirmações com âncoras de evidência antes de redigir o resumo final.
5. Preencha as dimensões obrigatórias:
   • 研究目的 (Propósito da Pesquisa)
   • 主要贡献 (Principais Contribuições)
   • 使用技术/方法 (Técnicas/Métodos Utilizados)
   • 实验与结果 (Experimentos e Resultados)
   • 不足/局限 (Limitações/Fraquezas)
   • 未来前景/后续工作 (Perspectivas Futuras/Trabalhos Futuros)
6. Para cada dimensão, inclua todos os pontos materiais explicitamente presentes no artigo.
7. Adicione itens inferidos com cautela somente após todos os itens de conteúdo original, e rotule-os claramente como 合理推测.
8. Produza primeiro a saída Markdown, agrupando a lista de afirmações sob os cabeçalhos de dimensão.
9. Crie a saída Excel usando scripts/write_paper_summary_excel.py quando a criação de arquivos estiver disponível.
10. Arquivar os arquivos Markdown, JSON e Excel gerados usando scripts/archive_summary_outputs.py quando a criação de arquivos estiver disponível, para que a página web de gerenciamento de literatura possa descobrir automaticamente o novo artigo. Prefira uma estrutura local onde uma pasta de artigo contenha o PDF/texto extraído da fonte e as saídas de resumo geradas; a página web importará apenas os arquivos de saída do resumo.

Saída Markdown

Use esta estrutura:

# Resumo do Artigo: <Título do Artigo ou Nome do Arquivo Fornecido pelo Usuário>

## Informações Básicas

- Título:
- Autores:
- Ano/Conferência ou Periódico:
- Área de Pesquisa:
- Observações sobre Integridade da Fonte:

## Visão Geral

<Resuma em 3 a 6 frases o problema resolvido, o método e as conclusões do artigo. Escreva apenas informações suportadas pelo texto original.>

## Resumo Detalhado

### Propósito da Pesquisa
- 【Texto Original – Alta】... (Base: Resumo; Introdução)
- 【Texto Resumido – Alta】... (Base: Introdução)

### Principais Contribuições
- 【Texto Original – Alta】... (Base: Tópicos de Contribuição)

### Técnicas/Métodos Utilizados
- 【Texto Original – Alta】... (Base: Método)

### Experimentos e Resultados
- 【Texto Original – Alta】... (Base: Experimentos; Tabela 1)

### Limitações/Fraquezas
- 【Texto Original – Alta】... (Base: Limitações; Conclusão)

### Perspectivas Futuras/Trabalhos Futuros
- 【Texto Original – Alta】... (Base: Conclusão)

## Lista de Inferências

| Item Inferido | Base da Inferência | Confiança | Sugestão de Verificação |
|---|---|---|---|
| ... | ... | Alta/Média/Baixa | ... |

## Limitações do Texto Original a Observar
- ...

Diretrizes:

• Mantenha o conteúdo original e inferido visualmente distintos, colocando o tipo e a confiança no início de cada marcador, por exemplo 【Texto Original – Alta】.
• Cada dimensão obrigatória deve aparecer uma vez como cabeçalho. Coloque vários pontos sob esse cabeçalho como marcadores.
• Se uma dimensão não tiver suporte no artigo, inclua um marcador rotulado como 【Não Mencionado – 】 e explique que o artigo não fornece a informação.
• Adicione um marcador separado 合理推测 apenas se uma inferência cuidadosa for útil, e também a liste na Lista de Inferências.
• Inclua a Lista de Inferências mesmo quando vazia; escreva Nenhuma quando nenhuma inferência foi usada.
• Os marcadores agrupados no Markdown e as linhas de reivindicação do JSON/Excel devem descrever as mesmas reivindicações subjacentes, embora o Markdown seja agrupado para legibilidade.

Saída Excel

Quando o usuário solicitar saída Excel, ou quando arquivos puderem ser criados, produza uma pasta de trabalho .xlsx além do Markdown.

Use uma planilha chamada Resumo do Artigo com colunas:

• Dimensão
• Tipo
• Resumo
• Base no Texto Original / Base da Inferência
• Confiança
• Sugestão de Verificação

Use scripts/write_paper_summary_excel.py para criar a pasta de trabalho a partir de um arquivo JSON:

python scripts/write_paper_summary_excel.py summary.json paper_summary.xlsx

Formato JSON esperado:

{
  "paper_title": "Título do artigo",
  "authors": "Autor A; Autor B",
  "venue": "Periódico ou Conferência; Ano",
  "year": "2026",
  "field": "Área de pesquisa",
  "overview": "Um resumo curto do artigo para o cartão do gerenciador de literatura.",
  "rows": [
    {
      "dimension": "研究目的",
      "basis_type": "原文明确",
      "summary": "O que o artigo afirma.",
      "evidence": "Resumo; Introdução.",
      "confidence": "高",
      "review_suggestion": ""
    }
  ]
}

Mantenha as linhas JSON e Excel como registros no nível de reivindicação, ordenados pelas seis dimensões obrigatórias. Inclua os campos JSON de nível de artigo acima, quando disponíveis, para que a página web de gerenciamento de literatura possa renderizar cartões compactos com título, periódico/ano, tópico e resumo curto, em vez de inferi-los das linhas de reivindicação.

Saída de Arquivo Bibliográfico

Após criar as saídas Markdown, JSON e Excel, arquive-as para a página web dinâmica de gerenciamento de literatura:

python scripts/archive_summary_outputs.py summary.json paper_summary.md paper_summary.xlsx

Comportamento do arquivamento:

• Se SUMMARIZE_PAPER_LIBRARY_DIR estiver definido, arquive nesse diretório.
• Caso contrário, arquive em ~/Documents/summarize-paper-library/inbox quando a pasta Documentos existir.
• Caso contrário, arquive em ~/.summarize-paper-library/inbox.
• Coloque cada artigo em uma subpasta estável com o título do artigo e mantenha summary.json, summary.md, summary.xlsx e manifest.json juntos.
• Use --folder-name "Autor - Ano - Título" quando quiser que o nome da pasta corresponda a uma biblioteca paper/<pasta do artigo>/... curada manualmente.
• Use --timestamped apenas quando execuções versionadas devem ser mantidas em pastas separadas.

A página web pode monitorar a caixa de entrada do arquivo ou a pasta paper pai e atualizar automaticamente quando novas saídas da habilidade aparecerem. Ela escaneia subpastas recursivamente e importa apenas arquivos summary.*, paper_summary.* e *_paper_summary.*, ignorando PDFs e arquivos de texto extraídos.

Verificação de Qualidade

Antes de finalizar:

• Confirme se cada dimensão obrigatória está presente exatamente uma vez como cabeçalho Markdown.
• Confirme se vários pontos dentro de uma dimensão são marcadores sob esse cabeçalho, e não blocos de dimensão repetidos.
• Confirme se cada item de resumo factual possui uma âncora de evidência.
• Confirme se cada item inferido está rotulado como 合理推测.
• Confirme se nenhum item inferido está misturado em uma linha 原文明确 ou 原文概括.
• Confirme se as linhas de reivindicação JSON e Excel estão em conformidade com os marcadores Markdown agrupados.
• Confirme se as informações de origem ausentes são marcadas como 未提及 em vez de inventadas.
• Confirme se os arquivos gerados foram arquivados para a página web de gerenciamento de literatura quando a criação de arquivos estiver disponível.