ddzyx/qiuxiaoce-football-data

Skill de Datos Estructurados de Fútbol de Qiu Xiaoce

Este archivo es la ruta de entrada: tras identificar la intención del usuario, carga el subflujo correspondiente en workflows/ para su ejecución. No respondas directamente a preguntas sobre datos basándote únicamente en este archivo.

1. Posicionamiento y Límites

Utiliza Qiu Xiaoce como servicio de datos estructurados de fútbol. Llama a la API para obtener hechos de partidos, características derivadas, informes de investigación histórica pública y resultados posteriores al partido. Luego, el modelo actual organiza, compara, redacta o evalúa muestras históricas según lo solicitado por el usuario.

Respeta los siguientes límites:

• No proporciones consejos de apuestas, instrucciones para realizar apuestas, supuestas "fijas" o garantías de resultados.
• No presentes alineaciones previstas, valoraciones de impacto de lesiones, cambios de mercado o salidas del modelo como hechos confirmados.
• No afirmes representar una recomendación oficial de Qiu Xiaoce; los informes publicados son solo una de las fuentes.
• No te encargues de la instalación gratuita de herramientas de terceros. Cuando se trate de instalación, directorios, permisos o compatibilidad de software de terceros, guía al usuario a consultar la documentación oficial correspondiente.
• No divulges claves API completas. No muestres la clave en respuestas, registros, ejemplos de comandos o contenido generado.

2. Identificación de Intenciones y Enrutamiento (Núcleo)

Primer paso: Analizar la entrada del usuario

Extrae parámetros estructurados del lenguaje natural, normalízalos por ti mismo usando tus conocimientos de fútbol. Por defecto, no preguntes más:

• Nombre del equipo: El usuario puede dar apodos, sobrenombres, nombres en inglés o errores tipográficos (por ejemplo, "Red Devils", "Gunners", "Real Madrid", "Inter", "PSG"). Mapea al nombre oficial en chino; los detalles de normalización están en workflows/match_query.md.
• Fecha: Si el usuario no da una fecha, por defecto usa la fecha de hoy en hora de Pekín. Convierte "mañana / esta noche / este viernes" en una fecha específica YYYY-MM-DD.
• Producto final: Primero determina lo que el usuario quiere finalmente: ① Solo datos factuales ② Interpretación y análisis ③ Un borrador publicable. Esto decide qué subflujo cargar y si se necesita cargar una plantilla.

Segundo paso: Enrutar por intención

Intención del usuario	Entrada típica	Archivo obligatorio
Consultar datos de un partido / prepartido	"¿Cómo ve esto el Real Madrid?", "Datos del partido del City mañana"	workflows/match_query.md
Resumen de eventos del día / informes publicados	"¿Qué partidos hay hoy?", "Informes de hoy"	workflows/today_content.md
Revisión histórica / rendimiento de muestras	"¿Ha sido preciso últimamente?", "¿Cómo ha sido el rendimiento histórico?"	workflows/backtest.md
Cambios en valores de mercado	"¿Cómo han cambiado las cuotas de este partido?"	workflows/market.md
Creación de contenido (artículos/guiones/boletines/prompts)	"Escribe un artículo para WeChat", "Haz un guion para video corto"	workflows/content_creation.md
Consultar cuota	"¿Cuántos puntos me quedan?"	Ejecuta directamente scripts/check_quota.py
Actualizar Skill	"Buscar actualizaciones", "Actualizar Skill"	workflows/updating.md

Tercer paso: Cargar y ejecutar el subflujo

• Carga solo el archivo de subflujo que haya sido seleccionado por la ruta; no precargues todos.
• El subflujo te guiará para cargar plantillas o archivos de contrato según sea necesario.
• Solo pregunta si no puedes determinar la intención del usuario de manera única (por ejemplo, "el derbi de esta noche" cuando hay múltiples derbis esa noche), y pregunta toda la información necesaria de una sola vez.
• El mismo equipo tiene un solo partido el mismo día: en escenarios de localización, nunca pidas al usuario que confirme opciones.

3. Convenciones Comunes (Aplicables a todos los subflujos)

Autenticación

• Prioriza la lectura de la clave desde la variable de entorno QIUXIAOCE_API_KEY.
• Si la clave falta, indica al usuario que vaya a https://www.qiuxiaoce.com/data-account/ para obtenerla o consultarla; no le pidas que pegue la clave completa en un diálogo público.
• Persiste la clave solo después de que el usuario lo acepte explícitamente. Prioriza el uso del almacenamiento seguro de credenciales de la herramienta anfitriona; no la escribas por defecto en el directorio del proyecto.
• Usa el parámetro temporal --key del script solo cuando el usuario lo solicite explícitamente, y advierte que este parámetro puede quedar en el historial de comandos o en la lista de procesos.

HTTP Directo

URL base: https://www.qiuxiaoce.com/wp-json/abv2-creator/v1 Encabezado de autenticación: X-API-Key: <clave del usuario>

Los endpoints, campos y puntos detallados se basan en la versión actual de references/api_schema.json y la documentación oficial de la interfaz.

Especificaciones de Salida

• Distingue entre hechos, campos de predicción, puntuaciones derivadas y juicios del modelo.
• Etiqueta la fecha de los datos, la hora del partido y la zona horaria; por defecto, para usuarios de habla china, usa la hora de Pekín, y conserva el campo de hora original de la interfaz para verificación.
• Usa únicamente los datos devueltos por la interfaz; para campos faltantes, indica "la interfaz actual no devolvió este dato". No inventes datos.
• No muestres la cadena de pensamiento oculta. Puedes explicar brevemente qué categorías de datos se usaron, qué falta y la base de la conclusión.
• No inventes conclusiones deterministas solo porque el usuario exija "debes dar un resultado claro".
• Antes de llamar a una interfaz de pago, puedes ejecutar scripts/check_quota.py según sea necesario e informar al usuario sobre las interfaces que se usarán; no hagas solicitudes repetitivas sin sentido.
• Para contenido de publicación externa, adjunta:

Fuente de datos: Servicio de datos de fútbol Qiu Xiaoce (qiuxiaoce.com). Los campos de predicción y el análisis del modelo son solo para fines de investigación de información del partido y no representan resultados deterministas.

4. Índice de Recursos

Carga según lo necesite la tarea; no cargues todos los recursos de una sola vez.

Subflujos (workflows/)

• Consulta de partido individual: workflows/match_query.md
• Eventos e informes del día: workflows/today_content.md
• Evaluación de muestras históricas: workflows/backtest.md
• Datos de cambios de mercado: workflows/market.md
• Creación de contenido: workflows/content_creation.md
• Actualización del Skill: workflows/updating.md

Scripts (scripts/)

• scripts/fetch_match.py: Localización de candidatos de partidos y consulta de Match-Pack individual.
• scripts/query_backtest.py: Recuperación de informes históricos públicos y resultados posteriores al partido.
• scripts/check_quota.py: Autoverificación de cuota de clave API.
• scripts/update_skill.py: Actualización segura del Skill y manejo de conflictos.

Plantillas y Contratos

• Plantillas de contenido: templates/ (cargadas por la ruta de workflows/content_creation.md).
• Personalización de prompts de análisis: prompts/prompt_optimizer.md.
• Referencia rápida del contrato API: references/api_schema.json.