5.1 零代码实操:在 WorkBuddy 一键挂载球小策 Skill
智能体核心
内容太多,看不完或者看不太懂?
复制一段话发给你的 AI,它会自己读完官方文档、装好技能包,再来回答你的问题。
点这里复制给 AI →
想知道每项数据覆盖了哪些赛事?
88 项赛事的数据项覆盖情况一览:赛程比分、首发阵容、球员与球队统计、进阶指标、伤停、天气等,每日自动统计并如实公开。
查看数据覆盖说明 →
把下面这段发给你的 AI,它就知道该做什么
点「复制全文」,粘贴到你的 AI 对话框发送即可,无需改动。
你正在阅读球小策(www.qiuxiaoce.com)的官方文档或数据服务页面。请按下面 5 步执行,不要跳步。
【预备】我的专属数据密钥是 X-API-Key = [在此粘贴你的 Key]
(第 2 步和第 3 步都会用到它;还没有密钥,先到 https://www.qiuxiaoce.com/data-account/ 免费领取)
━━━ 第 0 步 · 三条硬性纪律 ━━━
1. 凡涉及指标定义、接口参数、计费规则、准确率口径的问题,一律以站内官方文档为准,不要凭记忆作答;文档里没写的,就直接告诉我「文档未说明」。
2. 如果你无法访问下面任何一个网址,请立刻停下来告诉我,不要用记忆里的内容顶替。
3. 本站只做数据分析,不提供任何投注建议,也不做准确率承诺。回答时请守住这条边界。
━━━ 第 1 步 · 遍历官方文档(100+ 篇,按需取,别一次全拉)━━━
· 取全量目录(公开接口,无需密钥,返回全部篇章的标题与 slug):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs
· 读单篇正文(把 {slug} 换成上一步拿到的标识):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs/{slug}
· 人读版页面(适合只能浏览网页、拿不到 JSON 的环境):
https://www.qiuxiaoce.com/creator-docs/{slug}/
· 接口文档(全部数据接口的用途、参数、计费与真实返回示例):
https://www.qiuxiaoce.com/data-docs/
做法:先取目录 → 判断我的问题涉及哪几篇 → 只读那几篇 → 回答时注明依据的篇名或链接。
━━━ 第 2 步 · 先判断你自己的能力,再选路径(关键,不可跳过)━━━
· A 类:能在本机读写文件或执行命令——桌面/终端类 AI 工具(WorkBuddy、Qoder、Trae 等)
· B 类:只能对话,访问不了文件系统——网页版对话(豆包、通义千问、Kimi 等)
【A 类 · 安装官方 Skill(推荐)】
1. 取最新版本信息:
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/skill/version
返回 version、download_url、sha256 校验清单、文件列表与更新说明。
2. 按 download_url 下载技能包,并用返回的 sha256 逐文件校验。
3. 解压到你的技能目录,保持包内顶层目录结构;按包内 SKILL.md 完成初始化。
4. 写入我的专属密钥(即上文【预备】里的 X-API-Key)。
5. 装完告诉我:版本号、安装位置、密钥是否已生效。
【B 类 · 装不了就照实说,不要假装】
不要声称已安装,也不要拿记忆里的内容替代文档。请直接对我说:
「当前环境不支持安装 Skill(无法读写本地文件)。有两个办法:
① 改用支持 Skill 的桌面 AI 工具,如 WorkBuddy、Qoder、Trae;
② 把你的 API Key 给我,我按官方接口文档直接取数分析。」
如果你连「打开指定网址」都做不到,请把这一点也一并告诉我。
━━━ 第 3 步 · 直接用接口取数(两条路径都适用)━━━
· 接口根地址:https://www.qiuxiaoce.com/wp-json/abv2-creator/v1
· 认证方式:请求头带上【预备】里的 X-API-Key
· 想先试不扣点数的接口,看 https://www.qiuxiaoce.com/data-docs/ 里标注为免费的端点。
· 大批量调用前先查一次剩余点数,避免跑到一半失败。
━━━ 第 4 步 · 遇到报错,先查官方排障手册再重试 ━━━
排障手册:https://www.qiuxiaoce.com/creator-docs/api-error-codes-troubleshooting/
· 401:Key 缺失、格式不对,或该 Key 已被重置/吊销(控制台执行「重置 Key」后旧 Key 立即失效,错误码 api_key_revoked 即属此类)→ 到 https://www.qiuxiaoce.com/data-account/ 复制最新完整 Key,并同步更新所有已配置该 Key 的脚本与客户端
· 402:点数不足或已过期 → 需到 https://www.qiuxiaoce.com/data-service/ 充值
· 403:接口未开放,或权限不足(个别场次报告需要订阅)
· 404:实体 ID 或接口路径写错
· 429:请求过快,按响应头 Retry-After 等待后重试
报错时请把原始错误信息原样转述给我,不要猜原因。
━━━ 第 5 步 · 回答我时的要求 ━━━
· 区分「官方事实数据」「接口返回的判断字段」「衍生评分」「你自己的推断」四类,不要混着说。
· 使用 xG、xGA、OTI、DII 这类指标前,先按文档校正口径;样本不足要在结论里注明。
· 缺数据就说缺什么,不要用「大概」「可能」糊过去。
· 不给投注建议,不承诺准确率。
· 如果回答主要依据了某篇文档,请把链接带上,方便我自己核对。
复制后直接发给你的 AI(豆包、千问、WorkBuddy、Qoder 等都可以)。
这一篇全程不需要写任何代码。你要做的只有一件事:把一段话发给你的 AI 工具。
一、Skill 到底是什么,为什么装了它就能用上数据?
你可以把它理解成给 AI 装的一个「专业插件」。
没装之前,你的 AI 是一个什么都懂一点的通才:会写文章、会讲道理,但它不知道今天的比赛是哪几场,也不知道某支球队的预期进球是多少。你问它这些,它只能靠印象回答——或者干脆编一个。
装上球小策 Skill 之后,它多了三样东西:
| 它多了什么 | 你能感受到的变化 |
|---|---|
| 一套取数能力 | 你说「我要写曼城这场」,它会自己去查赛程、定位比赛、把数据取回来,而不是反问你「请提供数据」 |
| 一套分析流程 | 它知道该先盘点数据、再推演、最后成文,不会一上来就给你一堆空话 |
| 一套合规与格式规则 | 它默认知道哪些词不能写、市场数据该怎么说、结尾要不要附来源声明 |
最关键的差别是:从「你想办法把数据喂给它」变成「它自己去拿数据」。这一步跨过去,后面的所有事都轻松了。
二、安装前需要准备什么?
- 一个支持 Skill 的 AI 工具:WorkBuddy、Cursor、Trae 这类能在你电脑上跑命令的工具都可以。纯网页版对话通常装不了(详见 2.8 工具差异)。
- 你的专属密钥:在 我的数据服务 微信扫码登录,复制以
qxz_开头的那串密钥(见 4.1)。 - 不用准备代码,不用装 Python 包。技能包只依赖 Python 标准库,工具自己会处理。
如果你用的是网页版,也不用灰心——2.9 和 2.10 的指令卡可以手动复制数据后用。
三、怎么用一句话完成安装?
在 WorkBuddy 里新建一个对话,把下面这段整段发出去。密钥已经自动填好了,你一个字都不用改。
💬 一键安装球小策 Skill(密钥已自动填入) 安装
帮我安装球小策足球智能体技能包。
官网源:https://www.qiuxiaoce.com/data-docs/
我的专属数据密钥是:YOUR_API_KEY_HERE
请按下面四步做,每完成一步告诉我结果:
1. 把技能包安装到当前环境,并把这个密钥保存到环境配置中;
2. 初始化足球分析技能,确认它能正常加载;
3. 调用一次余额接口做连通性自检,告诉我剩余点数与有效期;
4. 告诉我技能包的版本号,以及你当前可用的工作流清单。
如果你在执行中遇到任何障碍(缺环境、下载失败、权限问题),直接告诉我具体缺什么,不要跳过步骤假装完成了。
正常情况下它会一路做完,然后回来报版本号和可用能力。这一句话你以后不用再记,控制台首屏也提供了同样的口令。
四、怎么确认装成功了?
用这一步做验收。关键看它有没有真的去调接口——而不是嘴上说「已安装」。
💬 验证安装:真的能查到数据吗(复制发送) 验证
请做一次完整的连通性验收,逐项回答,不要跳过任何一项:
1. 技能包是否已加载?版本号是多少?
2. 我的密钥前 4 位是什么(只显示前 4 位,其余用 * 代替)?
3. 调用余额接口,告诉我当前剩余点数、有效期和每分钟限流设置;
4. 列出你现在能用的全部工作流,每个用一句大白话说清它能做什么;
5. 告诉我:接下来我可以怎么使唤你(给我 3 个可以照抄的例子)。
要求:每一项都要有实际执行的结果;如果某一项做不到,就写「这一项做不到,原因是……」,不要用「应该可以」这类模糊说法。
五、装不上或报错怎么办?
三个最常见的故障,每个对应一段可以直接发出去的话。
💬 排障 A:它说找不到技能包 排障
请检查当前环境里到底有没有安装 qiuxiaoce-football-data 这个技能包。
请回答:
1. 你检索了哪些目录?分别在哪个路径下找过?
2. 你现在实际能加载的技能有哪些(把完整列表给我)?
3. 如果没有找到球小策技能包,请告诉我应该安装到哪个目录才能让你读到。
不要跳过这个前提直接开始分析。前提没确认之前,不要回答任何数据类问题。
💬 排障 B:它说密钥不对 排障
请确认你实际读到的密钥是什么(只显示前 4 位和最后 4 位,中间用 * 代替),并回答:
1. 你是在哪个位置读取到它的(环境变量名或文件路径)?
2. 接口返回的原始错误信息是什么(原样贴出来,不要改写)?
3. 你判断问题出在密钥本身、还是出在调用方式?
确认清楚之前,不要用猜测的密钥去重试,也不要把密钥完整打印出来。
💬 排障 C:怀疑它没真的查数据 排障
请确认:你刚才的回答里,哪些数字是真正调用球小策数据接口拿到的?
请逐条列出:
1. 你调用了哪个接口、传了什么参数;
2. 返回结果里的原始字段名是什么;
3. 哪些内容不是来自接口,而是你的推断或印象——这部分请明确标注出来。
凡是你不能证明来自接口的数字,请全部删掉,改写为「当前数据未提供」。从现在开始,没有真实数据支撑的结论不要写。
三段里最值得记住的是第三段。判断 AI 有没有真的查数据,最简单的办法就是让它报字段名——真数据能说出 xg、form_rating 这些字段,编的说不出来。
六、装好之后的使用原则是什么?
- 说人话,不用说术语。「帮我看看今晚曼城那场」就够了,它会自己解析队名、定位比赛。你不需要知道任何接口名;
- 先要数据,再要观点。第一句让它盘点数据,第二句再让它分析——一次要结论,出来的多半是空话;
- 它说「拿不到」时,相信它。那通常是真的没有,不是它偷懒。逼它给答案,它就会开始编;
- 花点数前先问一句。「这件事大概要花多少点?」它会告诉你,避免你在不知情的情况下调用高价接口。
下一步该看什么?
- 它到底能做什么 → 5.2 Skill 能力全景
- 看一次完整实战 → 5.3 端到端实战
- 不装 Skill 也能用 → 2.9 指令卡片库①
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策