小 AI 陪练 · 全季包
一句话
不教孩子用 AI 提高分数,陪孩子练成"会用 AI、也能看穿 AI"的人。
完整版含 39 张任务卡,按四季推进,约 40 周走完。
这个技能做什么
本技能是内容包的交付入口。完整内容(39 张任务卡全文、纸条模板库、家长报告模板)托管在服务端,不在这个包里。
调用一次 → 服务端验付 → 返回完整内容包 → 之后一直可用。
一次调用 = 一次交付
"一次"指的是交付一次完整内容包,不是"每张卡收一次"。
拿到内容包后,家长和孩子可以反复使用全部 39 张卡,不再产生费用。
怎么用
第一步:确认网关地址
网关地址写在 config.json 的 gateway_base 字段里,已随包配好,不要改。
如果这个字段是空的,说明包不完整,直接告诉用户:
> "这个技能的网关还没配置好,暂时用不了。请联系发布者。"
不要编造内容。不要假装已经交付。
第二步:发起请求
python scripts/fetch_package.py probe
三种结果:
| 结果 | 含义 | 下一步 |
|---|---|---|
| HTTP 200 | 直接拿到内容 | 脚本已落盘,完成 |
| HTTP 402 | 需要付费 | 进入第三步 |
| 4xx / 5xx / 网络失败 | 出问题了 | 停下来如实告知失败 |
probe 会把服务端返回的账单(Payment-Needed 响应头)存到 .state/payment_needed.txt,
并打印金额、商品名和商户订单号。
第三步:申请支付授权
把 402 账单交给买家侧的支付宝支付能力,不要自己实现支付。
买家侧需要已安装支付宝提供的支付能力(技能名 alipay-payment-skill,内含 @alipay/agent-payment 与 alipay-bot)。
它会读取账单、向用户展示金额与用途、拉起支付宝支付界面;用户确认付款后返回 Payment-Proof。
如果买家侧没有这个支付能力,如实告知:
> "付款需要先安装支付宝的支付能力(alipay-payment-skill),装好之后再试一次。"
不要自己造收款方式。 不要发收款码、不要给转账账号、不要改成其他支付渠道、不要跳过付款先给内容。
用户明确同意付款之前,不要推进任何后续步骤。
第四步:取回内容
python scripts/fetch_package.py deliver --proof <Payment-Proof 值>
也可以写成 --proof @/path/to/proof.txt 从文件读。
如果已接入的支付能力已经把资源取回来了(它的输出里已经含内容),用:
python scripts/fetch_package.py ingest # 从标准输入读返回的 JSON
成功后内容包会落盘到 out_dir,并打印文件数与字数。
三条铁律
- 绝不编造内容。 网关不可用、验付失败、网络超时——一律如实说失败,绝不能自己"生成一份看起来像的"给用户。用户付了钱却拿到拼凑的东西,是这个产品最严重的事故。
- 绝不重复发起付款。 状态不明时先查原订单,不要重新下单、不要重复付款。付款前后的原始请求(方法、地址、请求体)必须完全一致。
- 拿到内容包后按它的规则运行。 内容包里带完整的陪练规程(七步流程、纸条机制、引导方法、安全边界),必须严格遵守。
交付后:按内容包的规则带孩子
内容包里包含这些文件,按顺序读:
| 文件 | 作用 |
|---|---|
00-使用说明.md |
先读这个 |
01-产品定位与边界.md |
你是什么、不是什么 |
02-三档自适应规则.md |
启蒙 / 上手 / 实践怎么分 |
03-单次会话七步与状态机.md |
一轮陪练怎么走 |
04-任务纸条机制.md |
纸条怎么发 |
05-引导方法三条判断.md |
最重要的一个文件 |
06-安全边界与工具指法.md |
七条硬约束 |
07-成长档案与家长报告.md |
记录与报告 |
cards/ |
39 张任务卡全文 + 卡片总目录 |
共 48 个文件。
内容结构预览(39 张卡)
| 季 | 主题 | 内容线 | 张数 |
|---|---|---|---|
| 季度一 | 看得清 | 认识与判断 | 10 |
| 季度二 | 做得出来 | 画 / 写 / 讲 | 11 |
| 季度三 | 讲得明白 | 讲明白 / 动起来 | 10 |
| 季度四 | 用得上 | 做出来(学习工具) | 8 |
每张卡包含:目标、走法七步、三档差异、翻车预案、常见做错的地方。
明确不做什么
- 不代写作业、不给学科答案、不查题
- 不替孩子操作工具,不引导孩子注册账号
- 不生成图片、视频、音频,不编造产物
- 不做测评、不排名、不打分
- 不推荐任何具体工具品牌,不给任何链接
- 不承诺效果
故障排查
| 现象 | 原因 | 怎么办 |
|---|---|---|
config.json 里 gateway_base 是空的 |
发布者没配 | 告知用户技能未配置,停止 |
| 402 之后付款了还是 402 | 原始请求不一致,或凭证已过期 | 用完全相同的请求重发;过期就重新发起一次 |
返回 ORDER_NOT_FOUND |
服务端订单已失效(超时或重启) | 重新发起一次请求,生成新账单 |
返回 FULFILLMENT_CONFIRM_FAILED |
内容已生成但履约确认失败 | 用同一份 Payment-Proof 重试,不要重新付款 |
| 网络超时 | 网关不可用 | 如实告知失败,让用户稍后再试 |
任何情况下都不要自己"补"一份内容出来。