5.4 提示词工程①:结构化提示词的骨架
提示词
内容太多,看不完或者看不太懂?
复制一段话发给你的 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 的表现会稳定很多。
一、一个完整提示词由哪六段构成?
| 段落 | 回答什么 | 缺了会怎样 |
|---|---|---|
| 角色 | 你是谁、写给谁看 | 输出变成通用新闻稿 |
| 数据 | 数据从哪来 | 它开始凭记忆编 |
| 任务 | 具体做什么、做到哪一步 | 你不知道它会给你什么 |
| 框架 | 按什么顺序分析 | 逻辑跳跃、重点漂移 |
| 输出 | 什么格式、多少字 | 拿到一堆要重排的文字 |
| 边界 | 不许做什么 | 越界:编数据、给结论、用违禁词 |
注意第二段「数据」——很多提示词教程只讲五段,把数据漏掉了。而这一代 AI 最大的问题恰恰出在数据上:它不知道数据从哪来,就只能编。
二、可以直接套用的骨架模板是什么?
💬 万用提示词骨架(改中括号里的内容即可) 模板
【角色】
你是【足球赛事数据分析师 / 自媒体主笔 / 短视频编导】,产出用于【公众号 / 小红书 / 口播稿】,读者是【有一定基础但不需要专业术语的球迷】。
【数据】
先调用球小策数据接口取【主队】对【客队】在【日期】这场比赛的数据;如果取不到,直接告诉我取不到,不要凭记忆作答。只使用取回的数据,接口没返回的字段写「当前数据未提供」,不要估算或用相近数据替代。
【任务】
基于取回的数据完成【具体任务,例如:找出本场最值得关注的三个对位,并指出各自占优方】。
【框架】
按这个顺序做:① 先盘点数据(不带评价)→ ② 再做推演(每个判断绑定具体数值)→ ③ 最后按下面的格式成文。
【输出】
格式:【例如:三个小节,每节含小标题 + 2 到 3 行解读 + 一个支撑数据】
篇幅:【例如:800 到 1200 字】
禁止:【例如:不要客套开场,不要总结句,不要用感叹号】
【边界】
不提供任何投注建议;不出现稳、必胜、包中这类绝对化表述;涉及市场数据统一说「市场参考值」;事实与推断分开表述(推断用「可能 / 倾向 / 值得警惕」)。
这套骨架的价值在于可复用。换个用途,只改「角色」和「输出」两段就够了,其余五段(数据、边界)几乎不用动。
三、让它更听话的三个增强技巧是什么?
技巧一:给一个反面例子。告诉它「不要写成什么样」,比正面描述更有效——因为模型最容易犯的错就那么几种。
💬 增强一 · 给反面示例 模板
补充一个反面示例。我不想要这种写法:
「曼城本赛季表现出色,进攻端火力十足,防守也较为稳固,本场比赛值得期待。」
问题在于:没有任何具体数据,全是放之四海皆准的套话。
请按下面的要求重写:
1. 每一句话里至少包含一个具体数值或具体事实;
2. 凡是「出色」「不俗」「稳固」这类形容词,要么补上支撑数字,要么删掉;
3. 用「数据 + 它意味着什么」的结构替代形容词。
技巧二:让它先复述任务。动手之前先确认它理解对了——这一步能省掉大量返工。
💬 增强二 · 动手前先对齐理解 模板
开始之前,请先用三句话复述你对这个任务的理解:
1. 你要交付什么?给谁看?
2. 你的数据从哪里来?如果拿不到数据你会怎么做?
3. 你打算按什么顺序完成?
我确认之后你再动手。如果我看到你理解偏了,会在这里就纠正——不要跳过这一步直接开始写。
技巧三:分阶段交付。把大任务切成几段,每段做完停下来等你确认。
💬 增强三 · 分阶段交付,每段等确认 模板
这个任务请分三段做,每段完成后<strong>停下来等我确认</strong>,不要一口气做完:
第 1 段:取数并盘点数据,列出关键数值与口径;
第 2 段:基于数据做判断,每个判断附支撑数值;
第 3 段:按格式成文。
每段结束时,用一句话告诉我这段的产出是什么、有什么需要我确认的地方。
如果我在某一段提出了修改,请从该段重新开始,不要影响前面已确认的内容。
四、提示词要不要做版本管理?
要,但不用复杂。
你会发现有的提示词特别顺手——写成一篇稿子的成功率明显更高。把它存到一个备忘录里,标上用途和最后修改时间就够了。三个习惯最有用:
- 按用途命名:比如「公众号 · 赛前前瞻」「小红书 · 数据图鉴」,而不是「提示词1」「提示词2」;
- 记一句改动原因:「加了『不要总结句』——因为之前每次都写一段废话结尾」;
- 固定下来的直接固化:反复用的规则(比如合规边界)写进 AI 工具的长期配置或 Skill,不用每次粘贴。
五、写了很长的提示词还是没用,为什么?
| 现象 | 真正的原因 | 怎么改 |
|---|---|---|
| 提示词很长,输出还是很空 | 数据没到位,不是提示词的问题 | 先解决取数,再加约束 |
| 要求很多,它只做了一半 | 一次提了太多不相关的要求 | 拆成两轮,一次解决一件事 |
| 这次好用,下次就不好用 | 上一轮对话的上下文在干扰 | 开新会话重来,或按 2.7 摘要重启 |
| 它总是自己加戏 | 缺少「边界」那一段 | 明确写「只做这一件事,不要附加我没要求的内容」 |
| 格式每次都不一样 | 格式要求写在对话里、没固定 | 把格式写进 Skill 或工具的长期配置 |
一句话总结:提示词解决「怎么说」,数据解决「有没有东西可说」。只优化前者,天花板很低。
下一步该看什么?
- 三步分析法与防幻觉 → 5.5 提示词工程②
- 按你的账号风格定制 → 5.6 风格定制
- 现成卡片直接抄 → 2.9 指令卡片库①
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策