2.2 把模糊想法变成可执行任务:指令四要素模型
必读把下面这段发给你的 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 这类指标前,先按文档校正口径;样本不足要在结论里注明。
· 缺数据就说缺什么,不要用「大概」「可能」糊过去。
· 不给投注建议,不承诺准确率。
· 如果回答主要依据了某篇文档,请把链接带上,方便我自己核对。
「分析一下这场比赛」——这不是指令,是许愿。
一个合格的指令必须补齐四样东西:角色、任务、约束、格式。缺任何一样,模型都会替你猜,而它猜的方向通常不是你想要的。
这一篇把四样东西逐个讲透,最后给你三套可以直接复制的完整模板。
一、一个合格的指令,必须补齐哪四样东西?
| 要素 | 回答什么问题 | 缺了会怎样 | 写法示例 |
|---|---|---|---|
| 角色 | 你是谁、写给谁看 | 它按最通用的方式回答,输出像新闻通稿 | 你是一名体育数据分析师,写给有基础的球迷看 |
| 任务 | 具体做什么、做到哪一步 | 它不知道要结论还是要数据,容易跑偏 | 基于下面数据,找出本场三个关键对位 |
| 约束 | 不许做什么 | 越界:编数据、给预测、用绝对化词 | 不得编造未提供的数据,不得给投注建议 |
| 格式 | 输出长什么样 | 你拿到一坨没法直接用的文字 | 分三小节,每节带小标题,全文 600 字内 |
下面逐个看缺了会怎样——用真实的输出对比,而不是空讲道理。
二、缺「角色」会怎样?
同一份数据,加不加角色,输出是两种东西:
不加角色:「曼城近期状态不错,阿森纳也很有竞争力,这场比赛双方都有机会。」
加角色(你是一名体育数据分析师,为自媒体创作,读者是有一定基础的球迷):「从 xG 角度看,曼城近 5 场场均 1.94,高于赛季均值 1.71,进攻端在回暖——但对手平均排名偏低,这个回升要打折看。」
角色不只是「装个身份」。它同时定了三件事:专业密度、语言风格、读者是谁。这三件事定了,输出的取舍标准就定了——同样是「曼城进攻好」,写给普通球迷要解释什么是 xG,写给数据读者则要给出样本量。
三、缺「任务」会怎样?
「分析一下这场比赛」到底是给结论、给数据、找疑点,还是给你写稿素材?它只能猜。
把任务说到「下一步可执行」的粒度,输出才会可控:
模糊:帮我分析一下这场。
可执行:基于下面的数据,找出本场最值得关注的三个对位,每个对位指出哪支球队占优、依据是哪个数字。
判断标准很简单:你说完这句话,自己能不能立刻判断产出「对不对」。能,就是可执行的;不能,就还得说细。
四、缺「约束」会怎样?
不约束,模型会做三件你不想让它做的事:编数据、给预测、用绝对化表述。
这三件事里只有第三件是「它自己不老实」,前两件本质上是你没划边界。所以约束要写清两层:
- 数据层:「只使用我提供的数据;接口没返回的字段写『当前数据未提供』,不得用相近数据替代或估算」;
- 合规层:「不出现任何投注建议;不出现稳、必胜、包中、稳赢等表述;涉及市场数据时统一说『市场参考值』」。
这两条建议固化进你的常用指令。每次都不写,迟早翻车一次。完整红线见 6.6 合规红线。
五、缺「格式」会怎样?
格式决定这份产出能不能直接用。同一份数据,两种要求:
不说格式:出来 800 字连续段落,你还得重排一遍。
说清格式:「输出一张三列表格:维度 / 主队 / 客队,共 6 行;表格下面用两句话解读差距最大的一项。」
后者的产出可以直接贴进文章。格式模板见 2.5 强制输出结构。
六、四要素之外,为什么还要加「数据来源」?
因为四要素解决的是「怎么说」,数据解决的是「有没有东西可说」。这是新手最容易漏的一环,也是四要素模型和通用提示词教程最大的分歧点。
做法很简单,在四要素前面加一句固定的话:
数据来源:如果你可以调用球小策数据接口,先取【比赛 / 球队】的数据,再基于取回的数据完成任务;如果无法调用,请明确告诉我「我拿不到实时数据」,不要凭记忆作答。
装上 Skill 之后,这一句会真的被执行——它会解析队名、定位比赛、调 /match-pack/{fixture_id},把结构化数据摆到模型面前,然后再动笔。没有 Skill 的环境里,这句话至少能换来一句诚实的「我拿不到实时数据」,比让它编要好得多。装 Skill 的方法见 5.1 一键挂载 Skill。
七、三套可以直接复制的完整指令模板
下面三段都是完整可用的。中括号里的内容替换成你的实际信息,其余不用改。
八、只想要一句话版本怎么办?
有时候你只想快速试一下,不想写那么长。记住这个简化公式:
身份 + 动作 + 限制 + 形态
一句话例子:
作为体育数据分析师,基于下面的数据写三段对位解读,不要预测比分,每段不超过 100 字。
四个要素一个不少,效率最高。等用顺了,再回来用完整模板。
九、常见错误对照表
| 你写的 | 问题在哪 | 改后 |
|---|---|---|
| 「分析一下这场比赛」 | 任务太模糊,它只能猜方向 | 「基于下面数据,找出三个最值得关注的对位,每个带数值」 |
| 「写得专业一点」 | 「专业」没有可判断的标准 | 「读者是有基础的球迷,术语首次出现时用一句话解释」 |
| 「用你的数据帮我分析」 | 它没有数据,只会编 | 「先调接口取数,取不到就说取不到」 |
| 「顺便预测一下比分」 | 越过了合规红线,也超出了模型能力 | 「给一个进球趋势的定性判断,不写具体比分」 |
| 「写得越详细越好」 | 等于没有约束 | 「1200 字左右,四个小节,每节不超过 4 行」 |
| 「给我最好的方案」 | 「最好」无法执行,它只能给你套话 | 「给出一个主方案 + 一个备选,分别说明适用条件」 |
十、从「下命令」到「做协作」的四步节奏
最后一个认知升级:不要把 AI 当搜索引擎用(一问一答),要当同事用(一次对话推进一个任务)。
- 第 1 轮 · 只要数据:让它盘点数据,明确说不要结论;
- 第 2 轮 · 只要推理:确认数据没错之后,让它基于这些数据做判断;
- 第 3 轮 · 质疑与核对:挑出你觉得可疑的判断,问它依据是哪个数字;
- 第 4 轮 · 按你的形态成文:这时候才要求它按公众号 / 小红书 / 口播稿的格式输出。
这四步比一次性丢一个大指令效果好得多——因为每一步你都在它出错之前就卡住了。具体的追问话术见 2.3 追问话术总纲。
下一步该看什么
- 每一步具体该怎么说 → 2.3 追问话术总纲
- 直接把分析变成可发布内容 → 6.1 三分钟产出一篇公众号
- 把整套流程固化成 Skill → 5.2 Skill 工作流与模板
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策