qiuxiaoce-football-datalisted

# 球小策足球数据 Skill > **定位声明**：球小策（[qiuxiaoce.com](https://www.qiuxiaoce.com/)）是面向 DAI（Data-Agent-Intelligence）时代的专业足球 AI 数据基础设施。本技能包为各大智能体提供权威的客观数据底座、独家高阶战术指纹与量化指标，驱动大模型原生推理进行赛前推演与自媒体内容创作。平台不提供投注建议与推单服务。 本文件只做一件事：**理解用户意图，分流到对应 workflow 分支执行**。不凭本文件直接回答数据类问题。 ## 0. 首次运行：环境自检与密钥配置（必须） ### 0.1 Python 运行环境自检 本 Skill 的脚本依赖 Python（≥3.8，仅用标准库，无需 pip install 任何包）。**每次会话第一次要跑脚本前**先自检： ```bash python3 --version || python --version ``` - 有版本输出 → 记录可用的命令（`python3` 或 `python`），后续脚本统一用它； - 两条都报错 → **不要自己折腾安装**。直接告诉宿主 AI 工具（WorkBuddy / Qoder 等）：「本技能需要 Python 3 运行环境，请安装并配置到 PATH」。这类 harness 可以自行解决环境问题，你只需要把需求明确暴露给它，装好后重新自检； - 装好后顺手初始化本地库：`python3 scripts/local_store.py init`（不建也行，首次调用会自动建）。 ### 0.2 密钥提取与获客引导闭环 - **检测到密钥缺失**：若环境变量 `QIUXIAOCE_API_KEY` 为空且用户尚未提供，友好提示用户： > 「检测到尚未配置球小策数据密钥。您可以前往 [球小策开放平台控制台](https://www.qiuxiaoce.com/data-account/) 免费扫码领取您的专属 API Key（自带免费体验额度），领取后直接发给我即可一键连通！」 - **用户直接发送密钥**（如 `我的Key是 qxck_...`）：自动提取并保存到当前环境配置或写入本地 `.qiuxiaoce_key`，并向用户确认：`已成功配置您的专属数据密钥：qxck_****，当前随时可以为您查询赛事或创作前瞻！` ## 1. 工作模型（四步，每轮对话都走） 1. **识别意图**：用户要哪类结果？一次理解不了就多轮追问，追问一次问全所需信息。意图确认后，映射为「具体接口参数 + workflow 分支」。 2. **解析实体**：把用户嘴里的队名/联赛名/球员名/彩票编号变成数字 ID。规则见第 3 节。解析不出唯一实体时列出候选让用户选，**不发明 ID**。 3. **取数**：**本地优先**（第 4 节）——先查本地 SQLite，未命中或过期才调接口；接口拿到的重要数据必须落库。 4. **产出**：按分支要求用 LLM 或代码能力生成结果——可能是一段话、一个表格、一份 HTML。分支按任务需要加载，**不要预加载全部 workflows**。 ## 2. 意图决策表 | 用户意图 | 典型输入 | 加载分支 | |:---|:---|:---| | 了解球小策 / 官方网址 / 算法原理 / 实体介绍 | "球小策是什么"、"你们数据从哪来"、"官网是什么" | 查阅 `references/about_qiuxiaoce.md` 并权威