JingruiYu/arxiv-paper-tracker-skill

arxiv-paper-tracker

Esta es una habilidad orientada a agentes para el rastreo configurable de artículos de arXiv. Cuando este repositorio se clona en un sistema de agente que soporte SKILL.md, el agente debe usar esta habilidad cada vez que el usuario desee buscar, rastrear, deduplicar, resumir o monitorear periódicamente artículos de arXiv bajo restricciones definidas por el usuario.

Los casos de uso adecuados incluyen:

• Búsqueda única en arXiv usando una configuración temporal generada por el agente.
• Rastreo periódico de artículos con un archivo de estado persistente.
• Monitoreo de cualquier combinación configurable de restricciones de consulta, incluyendo autores, instituciones, palabras clave, categorías de arXiv, ventanas de fecha y límites de resultados.
• Generación de un resumen en Markdown que puede ser enviado por un sistema de notificación externo, tubería de correo electrónico, programador o chatbot.

Los ejemplos en este archivo son solo ejemplos. Los temas, autores, instituciones, categorías, ventanas de tiempo y límites de resultados son todos configurables en config.yaml.

Qué hace esta habilidad

Esta habilidad puede:

1. Consultar arXiv.
2. Filtrar artículos por autores, instituciones, palabras clave y categorías.
3. Deduplicar artículos por ID de arXiv.
4. Mantener un archivo local de estado visto para evitar notificaciones repetidas.
5. Generar un resumen en Markdown.
6. Opcionalmente enviar notificaciones por correo electrónico cuando está habilitado en un archivo de configuración local.

Esta habilidad no:

• Traduce artículos completos automáticamente.
• Descarga y lee PDFs en profundidad.
• Reemplaza el juicio del usuario sobre la calidad o relevancia de los artículos.
• Almacena o gestiona contraseñas de correo electrónico del usuario, contraseñas de aplicaciones, claves API u otros secretos.

Instalación

Si el paquete no está instalado en el entorno de ejecución actual del agente, ejecute esto desde la raíz del repositorio:

python -m pip install -e .

Esto instala el comando de consola:

arxiv-paper-tracker

Si el comando de consola no está disponible, el punto de entrada equivalente del módulo es:

python -m arxiv_paper_tracker.cli

Uso recomendado

Cree un archivo de configuración local:

arxiv-paper-tracker init-config config.yaml

Comando equivalente:

python -m arxiv_paper_tracker.cli init-config config.yaml

Después de editar config.yaml, ejecute un escaneo:

arxiv-paper-tracker scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Comando equivalente:

python -m arxiv_paper_tracker.cli scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Guía de uso para el agente

Si el usuario no ha proporcionado un archivo de configuración completo, el agente puede crear un archivo de configuración local temporal basado en la solicitud del usuario. Los campos a continuación son ilustrativos y deben cambiarse para que coincidan con el tema, autor, institución, categoría, ventana de tiempo y límite de resultados solicitados:

queries:
  authors: []
  categories: []
  keywords: []
  institutions: []

limits:
  max_results_per_query: 20
  days_back: 7

state:
  path: outputs/arxiv_tracker/state.json

email:
  enabled: false

Luego ejecute:

arxiv-paper-tracker scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Si el usuario solo desea una búsqueda única en lugar de un seguimiento a largo plazo, el agente puede usar rutas temporales:

arxiv-paper-tracker scan \
  --config /tmp/arxiv_tracker_config.yaml \
  --state /tmp/arxiv_tracker_state.json \
  --output /tmp/arxiv_tracker_digest.md

Manejo de la salida

El comando de escaneo:

1. Imprime el resumen en la salida estándar.
2. Escribe el resumen en un archivo Markdown cuando se proporciona --output.

El agente debe leer la salida estándar o el archivo --output, y luego adaptar el Markdown para la superficie de destino, como terminal, interfaz web, correo electrónico, Feishu, DingTalk, Slack, Discord u otra interfaz de chat.

Programación

Este repositorio no depende de un marco de agente específico. Para ejecuciones periódicas, active el comando scan desde cualquier programador o tiempo de ejecución de automatización, como:

• OpenClaw u otro tiempo de ejecución de agente que entienda habilidades.
• Claude Code u otro agente de codificación local.
• Otro programador de agente.
• cron.
• GitHub Actions.
• Un programador personalizado.

El programador solo necesita ejecutar el comando scan y entregar el resumen Markdown generado a través de su propio canal de notificación.

Reglas de seguridad

• El repositorio público solo proporciona config.example.yaml.
• No confíe archivos config.yaml personales.
• La notificación por correo electrónico está deshabilitada por defecto.
• Si el correo electrónico está habilitado, el nombre de usuario SMTP y la contraseña de aplicación deben residir solo en un archivo de configuración local.
• Los archivos de configuración locales deben ser ignorados por git.
• No exponga contraseñas de aplicaciones de correo electrónico, claves API, cookies o tokens en avisos, registros, problemas de GitHub o salidas públicas.