keros68/academic-reference-matcher-skill

Academic Reference Matcher

Resumen

Encuentra y verifica referencias académicas para un texto académico proporcionado por el usuario. Prefiere las herramientas integradas del agente (web, búsqueda, base de datos, navegador, citas o biblioteca); este skill proporciona el flujo de trabajo y el estándar de calidad, no una API externa obligatoria.

Reglas fundamentales

• Nunca inventes citas, DOI, nombres de autores, revistas o años de publicación.
• Separa "candidato a referencia encontrado" de "la referencia respalda la afirmación".
• Utiliza literatura primaria, revisiones sistemáticas, estándares, conjuntos de datos o documentación oficial antes que blogs y resúmenes secundarios.
• Conserva el estilo de cita y el idioma solicitados por el usuario. Si no se solicita ninguno, usa citas inline autor-año y una lista de referencias compacta.
• Para tareas Estándar o superiores, cuando el entorno de ejecución pueda crear archivos, prefiere archivos listos para copiar, especialmente si el usuario pide copiar, exportar o varios estilos de cita.
• Si no hay acceso a la web o bases de datos, solicita una bibliografía, exportación de búsqueda, lista de DOI, conjunto de PDF, biblioteca de Zotero o resultados de búsqueda pegados.
• Indica las limitaciones de acceso, las coincidencias débiles y las afirmaciones no verificadas, en lugar de rellenar huecos con referencias aparentemente plausibles.

Modos de tarea

Elige el modo según la solicitud del usuario:

• Añadir: encuentra citas para afirmaciones no citadas.
• Verificar: comprueba si las citas existentes respaldan las afirmaciones a las que están adjuntas.
• Reemplazar: encuentra referencias más sólidas o precisas para citas débiles, incorrectas, obsoletas, retractadas o inaccesibles.
• Formatear: convierte referencias conocidas al estilo solicitado sin realizar una nueva comprobación de relevancia.
• Extraer: identifica afirmaciones dignas de citación sin buscar aún.

Profundidad de búsqueda

Elige la profundidad más ligera que satisfaga la intención del usuario:

• Rápido: 1-3 afirmaciones, 3-5 referencias sólidas, verificación rápida de soporte.
• Estándar: párrafo o sección corta, tabla de afirmaciones, dos o más fuentes académicas cuando sea posible.
• Profundo: sección larga, antecedentes de revisión o tema controvertido; usa IDs de segmento, enrutamiento de fuentes y auditoría de búsqueda.
• Auditoría: preparación de revisión sistemática, transparencia tipo PRISMA o trabajo de manuscrito de alto riesgo; requiere un registro de búsqueda reproducible y limitaciones explícitas.

Si el usuario solicita "exhaustivo", "sistemático", "综述", "全面", "PRISMA", "meta-análisis" o "Cochrane", usa Profundo o Auditoría. Para Auditoría, indica el alcance y las limitaciones antes de comenzar.

Flujo de trabajo

1. Define el alcance de la tarea.

   • Identifica el campo, la sensibilidad a la fecha, el estilo de cita, el idioma, el modo de tarea y la profundidad de búsqueda.
   • Para documentos largos, procesa por sección y mantén estable la numeración de las citas.

2. Extrae afirmaciones dignas de citación.

   • Marca afirmaciones empíricas, causales, comparativas, cuantitativas, metodológicas, históricas o definicionales.
   • Asigna IDs de segmento estables (S001, S002, ...) para tareas con múltiples afirmaciones o texto largo.
   • No cites transiciones genéricas, antecedentes obvios o la contribución declarada del usuario a menos que se solicite.
   • Carga references/query-planning.md al convertir afirmaciones en consultas de búsqueda.

3. Busca de manera amplia, luego específica.

   • Comienza con frases exactas y términos técnicos clave de la afirmación.
   • Busca en fuentes de título/resumen/DOI antes que en la búsqueda web general, cuando estén disponibles.
   • Carga references/search-sources.md al elegir fuentes o construir consultas.
   • Carga references/source-routing.md para enrutamiento específico de dominio o trabajo Profundo/Auditoría.
   • Carga references/paywall-aware-access.md cuando los artículos relevantes estén tras un muro de pago o solo se vean metadatos.

4. Verifica la relevancia.

   • Lee suficiente del título, resumen, metadatos, fragmentos y texto completo disponible para juzgar el soporte.
   • Puntúa cada candidato usando references/verification-rubric.md cuando la tarea tenga múltiples candidatos o requisitos de alta precisión.
   • Prefiere artículos que respalden directamente la afirmación sobre artículos que solo compartan palabras clave.
   • Exige título, año, URL estable o DOI y una justificación de soporte antes de tratar una coincidencia como utilizable.
   • Trata el título, palabras clave y metadatos como señales de descubrimiento, no como soporte sólido, a menos que la afirmación sea puramente bibliográfica.

5. Formatea e inserta las citas.

   • Usa el estilo solicitado por el usuario. Carga references/output-formats.md para contratos de salida y notas de estilo.
   • Mantén las citas cerca de las afirmaciones que respaldan.
   • Incluye notas de incertidumbre para coincidencias débiles en lugar de exagerar la confianza.
   • Crea un informe Markdown listo para copiar cuando el usuario solicite un archivo, exportación, paquete de citas o salida fácil de copiar/pegar.
   • Para tareas Estándar o superiores, incluye una auditoría de búsqueda compacta. Carga references/search-audit.md.

Estrategia de búsqueda

Usa al menos dos fuentes académicas independientes para afirmaciones importantes cuando sea posible. Buen orden predeterminado:

1. Bibliografía proporcionada por el usuario, PDF, exportación de Zotero/Mendeley o biblioteca del proyecto.
2. OpenAlex, Crossref, Semantic Scholar, PubMed/Europe PMC, arXiv, páginas IEEE/ACM/ScienceDirect/Springer/Nature cuando sean accesibles.
3. Búsqueda web general solo para localizar páginas del editor, registros DOI, prepublicaciones o informes oficiales.

Para cada referencia seleccionada, captura la suficiente procedencia para que el usuario pueda auditarla: título, autores, año, lugar, DOI o URL estable, y una justificación de soporte de una oración.

Mínimos de evidencia

Para coincidencias de confianza Alta o Media, incluye:

• identidad bibliográfica: título, autores, año, lugar;
• localizador estable: DOI, PMID, arXiv ID, número de acceso, número de estándar o URL estable;
• base de evidencia: resumen, texto completo, metadatos, fragmento, PDF proporcionado por el usuario o registro oficial;
• justificación de soporte: una oración que vincule la referencia con la afirmación exacta.

Si falta alguno de estos, reduce la confianza o añade una nota.

Niveles de evidencia:

• Solo descubrimiento: el título, palabras clave, metadatos de índice, recuento de citas o listas de trabajos relacionados sugieren relevancia pero no establecen soporte.
• Respaldo por resumen: el resumen respalda directamente la afirmación; normalmente Medio a menos que la afirmación sea amplia y de bajo riesgo.
• Respaldo por texto completo: el texto completo, PDF proporcionado por el usuario, guía oficial, registro de conjunto de datos o página del editor respalda directamente la afirmación; elegible para Alto.
• Solo bibliográfico: los metadatos son suficientes solo para afirmaciones sobre existencia, autoría, año, lugar, DOI o estado de publicación.

Salida

Para solicitudes pequeñas, responde en prosa con citas insertadas y una lista de referencias.

Para tareas Estándar o superiores, o siempre que el usuario solicite "文件", "复制", "导出", "copy", "paste", "BibTeX", "RIS", "GB/T" o múltiples estilos de cita, crea archivos cuando sea posible:

• reference-match-report.md: informe principal listo para copiar con la revisión citada, tabla de afirmaciones-referencias, referencias, advertencias y auditoría de búsqueda.
• references-apa.md, references-gbt7714.md, references-vancouver.md o references-ieee.md: listas de referencias específicas del estilo cuando se soliciten.
• references.bib o references.ris: entradas legibles por máquina cuando se soliciten y haya suficientes metadatos verificados.

En el chat, devuelve un breve resumen y las rutas de los archivos. No dupliques el informe completo en el chat a menos que no se puedan crear archivos.

Para el emparejamiento de múltiples afirmaciones, usa esta tabla compacta:

Afirmación	Modo	Mejor referencia	Soporte	Base de evidencia	Confianza	Notas

Usa las siguientes etiquetas de confianza:

• Alta: respalda directamente la afirmación con población, método, mecanismo o resultado coincidente.
• Media: respalda el punto general pero difiere en alcance, método o contexto.
• Baja: solo antecedentes relacionados; no presentes como soporte sólido.

Termina con una sección "No se pudo verificar" para afirmaciones sin coincidencia fiable.

Para tareas Profundas o de Auditoría, incluye IDs de segmento en la tabla y un resumen de auditoría de búsqueda.

Limitaciones

• Este skill no tiene motor de búsqueda integrado, acceso a bases de datos de pago ni analizador de citas.
• La calidad de la búsqueda depende de las herramientas disponibles del agente anfitrión y del corpus proporcionado por el usuario.
• Los muros de pago, resúmenes faltantes, metadatos incompletos, límites de tasa y PDFs inaccesibles pueden debilitar la verificación.
• Los registros tras muros de pago aún pueden ser útiles para el descubrimiento y la clasificación de candidatos, pero la visibilidad solo de metadatos limita la confianza del soporte.
• La cobertura de la literatura no es exhaustiva a menos que el usuario proporcione un corpus delimitado o una estrategia de búsqueda de base de datos reproducible.
• El formateo final específico de la revista y las comprobaciones de manuscritos de alto riesgo aún pueden necesitar revisión humana.

Errores comunes

• No trates un alto recuento de citas como relevancia.
• No cites una revisión para un resultado experimental específico a menos que la revisión lo informe claramente y el usuario acepte fuentes secundarias.
• No uses un artículo solo porque su resumen contenga los mismos términos.
• No reemplaces una cita del usuario a menos que la referencia actual sea incorrecta, débil, retractada, inaccesible o esté fuera del alcance solicitado.
• No ocultes la falta de acceso. Indica lo que se verificó y lo que no se pudo abrir.
• No te bases en el scraping no oficial de Google Scholar o en soluciones CAPTCHA; utiliza registros académicos estables.
• No reclames cobertura exhaustiva a menos que el usuario haya proporcionado un corpus delimitado o una estrategia de búsqueda de base de datos reproducible.