Alitaliy/summarize-paper-skill

Resumir Artículo Académico

Descripción General

Utiliza este skill para resumir un artículo académico a partir de la fuente proporcionada por el usuario. Extrae el propósito, las contribuciones principales, las técnicas, las limitaciones y las perspectivas futuras del artículo, y genera tanto un resumen en Markdown como un libro de Excel cuando el entorno permite crear archivos.

Reglas Fundamentales

• Basa cada afirmación factual exclusivamente en el artículo proporcionado. No añadas contexto externo, intenciones del autor, afirmaciones sobre el impacto ni contexto del campo a menos que el usuario lo pida explícitamente.
• Separa el contenido declarado en el artículo de las inferencias. Marca cada elemento como 原文明确, 原文概括, 合理推测 o 未提及.
• Usa 合理推测 solo cuando el artículo no mencione directamente el elemento, pero la inferencia se derive lógicamente de métodos, resultados, limitaciones o la conclusión cercanos.
• Mantén un lenguaje cauteloso en las inferencias, utilizando frases como 可推测, 可能, 倾向于说明 o 未来可进一步.
• No sobreinterpretes. Si la evidencia es débil, marca el elemento como 未提及 o explica la incertidumbre en la columna de evidencia.
• Conserva los detalles importantes que el artículo realmente menciona, incluidos, cuando corresponda, el entorno de la tarea, el conjunto de datos, el modelo o marco de trabajo, la configuración experimental, las métricas de evaluación y las técnicas nombradas.
• Usa referencias de evidencia cortas en lugar de citas largas. Prefiere páginas, secciones, tablas, figuras o párrafos cuando estén disponibles.
• Si el texto del artículo está incompleto, escaneado o la calidad de la extracción es deficiente, indica esa limitación antes del resumen y evita llenar los vacíos con afirmaciones seguras.
• En el Markdown orientado al usuario, agrupa el contenido según las seis dimensiones requeridas y muestra múltiples afirmaciones como viñetas bajo la misma dimensión. No presentes 研究目的, 主要贡献 u otras dimensiones repetidas como secciones visuales separadas.
• Mantén las filas JSON/Excel estructuradas a nivel de afirmación para la trazabilidad, pero asegúrate de que las filas estén ordenadas por dimensión para que las páginas posteriores puedan agruparlas de forma limpia.

Flujo de Trabajo

1. Identifica el tipo de fuente del artículo: PDF, DOCX, Markdown, texto plano, extracto pegado o texto extraído.
2. Lee primero el resumen, la introducción, el método, los experimentos/resultados, la discusión, las limitaciones y la conclusión.
3. Escanea el resto del cuerpo en busca de afirmaciones que afecten a las categorías requeridas.
4. Construye una lista de afirmaciones con referencias de evidencia antes de redactar el resumen final.
5. Completa las dimensiones requeridas:
   • 研究目的
   • 主要贡献
   • 使用技术/方法
   • 实验与结果
   • 不足/局限
   • 未来前景/后续工作
6. Para cada dimensión, incluye todos los puntos materiales que estén explícitamente en el artículo.
7. Añade elementos inferidos con cautela solo después de todos los elementos de contenido original, y etiquétalos claramente como 合理推测.
8. Produce primero la salida en Markdown, agrupando la lista de afirmaciones bajo encabezados de dimensión.
9. Crea la salida en Excel usando scripts/write_paper_summary_excel.py cuando la creación de archivos esté disponible.
10. Archiva los archivos Markdown, JSON y Excel generados usando scripts/archive_summary_outputs.py cuando la creación de archivos esté disponible, para que la página web de gestión de literatura pueda descubrir automáticamente el nuevo artículo. Prefiere una estructura local donde una carpeta de artículo contenga la extracción del PDF/texto fuente y las salidas de resumen generadas; la página web solo importará los archivos de salida del resumen.

Salida en Markdown

Usa esta estructura:

# Resumen del artículo: <Título del artículo o nombre del archivo proporcionado por el usuario>

## Información básica

- Título:
- Autores:
- Año/Conferencia o Revista:
- Campo de investigación:
- Nota sobre integridad de la fuente:

## Visión general

<Resume en 3-6 oraciones el problema que resuelve el artículo, el método y las conclusiones. Escribe solo información respaldada por la fuente.>

## Resumen detallado

### Propósito de la investigación
- 【原文明确｜高】... (Evidencia: Abstract; Introduction)
- 【原文概括｜高】... (Evidencia: Introduction)

### Contribuciones principales
- 【原文明确｜高】... (Evidencia: Contribution bullets)

### Técnicas/Métodos utilizados
- 【原文明确｜高】... (Evidencia: Method)

### Experimentos y resultados
- 【原文明确｜高】... (Evidencia: Experiments; Table 1)

### Limitaciones/Inconvenientes
- 【原文明确｜高】... (Evidencia: Limitations; Conclusion)

### Perspectivas futuras/Trabajo futuro
- 【原文明确｜高】... (Evidencia: Conclusion)

## Lista de inferencias

| Elemento inferido | Base de la inferencia | Confianza | Sugerencia de verificación posterior |
|---|---|---|---|
| ... | ... | Alta/Media/Baja | ... |

## Limitaciones de la fuente a tener en cuenta
- ...

Directrices:

• Mantén el contenido original y el inferido visualmente distintos colocando el tipo y la confianza al inicio de cada viñeta, por ejemplo 【原文明确｜高】.
• Cada dimensión requerida debe aparecer una vez como encabezado. Coloca varios puntos bajo ese encabezado como viñetas.
• Si una dimensión no tiene respaldo en el artículo, incluye una viñeta etiquetada como 【未提及｜】 y explica que el artículo no proporciona esa información.
• Añade una viñeta separada de 合理推测 solo si una inferencia cuidadosa es útil, y regístrala también en Lista de inferencias.
• Incluye la Lista de inferencias incluso si está vacía; escribe 无 cuando no se haya utilizado ninguna inferencia.
• Las viñetas agrupadas en Markdown y las filas de afirmaciones en JSON/Excel deben describir las mismas afirmaciones subyacentes, aunque el Markdown esté agrupado para facilitar la lectura.

Salida en Excel

Cuando el usuario solicite salida en Excel, o cuando se puedan crear archivos, produce un libro .xlsx además del Markdown.

Usa una hoja de cálculo llamada 论文总结 con las columnas:

• 维度
• 类型
• 总结
• 原文依据/推测依据
• 置信度
• 后期核查建议

Usa scripts/write_paper_summary_excel.py para crear el libro a partir de un archivo JSON:

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

Formato esperado del JSON:

{
  "paper_title": "Título del artículo",
  "authors": "Autor A; Autor B",
  "venue": "Revista o Conferencia; Año",
  "year": "2026",
  "field": "Campo de investigación",
  "overview": "Una breve visión general del artículo para la tarjeta del gestor de literatura.",
  "rows": [
    {
      "dimension": "研究目的",
      "basis_type": "原文明确",
      "summary": "Lo que afirma el artículo.",
      "evidence": "Abstract; Introduction.",
      "confidence": "高",
      "review_suggestion": ""
    }
  ]
}

Mantén las filas JSON y Excel como registros a nivel de afirmación, ordenadas por las seis dimensiones requeridas. Incluye los campos JSON a nivel de artículo anteriores cuando estén disponibles para que la página web de gestión de literatura pueda mostrar tarjetas compactas con título, sede/año, tema y visión general en lugar de inferirlos de las filas de afirmaciones.

Salida de Archivo de Biblioteca

Después de crear las salidas Markdown, JSON y Excel, archívalas para la página web dinámica de gestión de literatura:

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

Comportamiento del archivo:

• Si SUMMARIZE_PAPER_LIBRARY_DIR está definido, archiva en ese directorio.
• De lo contrario, archiva en ~/Documents/summarize-paper-library/inbox si la carpeta Documents existe.
• De lo contrario, archiva en ~/.summarize-paper-library/inbox.
• Coloca cada artículo en una subcarpeta estable con el nombre del título del artículo y mantén juntos summary.json, summary.md, summary.xlsx y manifest.json.
• Usa --folder-name "Autor - Año - Título" cuando quieras que el nombre de la carpeta coincida con una biblioteca paper/<carpeta del artículo>/... curada manualmente.
• Usa --timestamped solo cuando se deban mantener ejecuciones versionadas en carpetas separadas.

La página web puede monitorear la bandeja de entrada del archivo o la carpeta paper principal y actualizarse automáticamente cuando aparezcan nuevas salidas del skill. Escanea recursivamente las subcarpetas e importa solo los archivos summary.*, paper_summary.* y *_paper_summary.*, ignorando PDFs y archivos de texto extraídos.

Control de Calidad

Antes de finalizar:

• Confirma que cada dimensión requerida esté presente exactamente una vez como encabezado de Markdown.
• Confirma que los múltiples puntos dentro de una dimensión sean viñetas bajo ese encabezado, no bloques de dimensión repetidos.
• Confirma que cada elemento de resumen factual tenga un ancla de evidencia.
• Confirma que cada elemento inferido esté etiquetado como 合理推测.
• Confirma que ningún elemento inferido esté mezclado en una fila 原文明确 o 原文概括.
• Confirma que las filas de afirmaciones JSON y Excel coincidan con las viñetas agrupadas de Markdown.
• Confirma que la información faltante de la fuente esté marcada como 未提及 en lugar de inventada.
• Confirma que los archivos generados se hayan archivado para la página web de gestión de literatura cuando la creación de archivos esté disponible.