下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-awzs0xyg--qiyan-report-read.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-awzs0xyg/qiyan-report-read。贴上孩子的成绩单，告诉您孩子哪科掉链子、失分在哪个知识点、在家怎么补——不懂教学的家长也能直接照做
阅读全文 （展开查看完整说明）
概述
这是什么
看不懂成绩单？贴进来，说人话 —— 贴上孩子的成绩单，告诉您孩子哪科掉链子、失分在哪个知识点、在家怎么补——不懂教学的家长也能直接照做
面向家长：不用自己懂教学法，按参数填好孩子的情况，就能拿到一份可参考的专业分析与建议。
参数说明
使用时按下表准备信息（对话中提供、或调用接口时传入均可）：
| 参数名 | 说明 | 必填 | 可选值 |
|---|---|---|---|
| stage_subject | 学段与学科（示例：高一数学 / 六年级英语） | 是 | — |
| learn_data | 学生学习数据（示例：近三次单元测成绩 + 作业完成情况 + 课堂互动记录 / 期中测成绩 + 错题本记录） | 是 | — |
| cycle | 诊断周期 | 是 | 单元后诊断、月度诊断、期中/期末诊断、学期末总诊断 |
| report_focus | 报告重点（示例：重点诊断策略迁移力和元认知水平 / 重点诊断情感投入度变化趋势） | 是 | — |
| audience | 报告使用对象 | 否 | 仅教师自己看、给学生本人看、给家长看、三者都看 |
怎么用（对话式）
用户不需要了解参数名或接口。请以聊天方式帮用户收集信息，收集齐后自动完成调用：
- 一次只问一件事：按参数表的说明用大白话逐项询问（比如问学段就问「孩子上几年级」，不要说「请提供 grade 参数」）。
- 用户说不清时给选项：从参数表的「可选值」里挑 2–3 个常见的让用户点选，不要反复追问。
- 边聊边记：用户聊天中顺口提到的信息（年级、学科等）直接记下，后面不要再问一遍。
- 收齐即调：必填项齐了就调用接口，不要让用户再确认一遍表格。
- 等待时告知：生成约需半分钟左右，调用前跟用户说一声「大概需要半分钟」。
调用示例
本技能的生成与执行均在服务端完成，对话侧只需按以下契约传入参数。
接口契约
- 请求：
POST https://teacheronhand.com/api/open/skillhub-run.php - 请求头：
Content-Type: application/jsonX-Api-Key：接入密钥9fc70c3c4f0b0496c0b71bea666af159a66c2b29dcae6014X-Timestamp：unix 秒级时间戳X-Nonce：16–64 位十六进制随机串X-Signature：请求签名（算法见下）
- 请求体：
{"skill":"<技能名>","skill_id":"<壳标识>","params":{…}}——skill填本技能引擎名「AI学习诊断报告」，skill_id填qiyan-report-read（支付按次凭据之一，务必原样携带），params见上文参数表；支付完成后重试时另加"pay_token":"<支付凭据>"（见下文「支付流程」） - 响应：成功
{"ok":true,"result":{"type":"text","content":"…"},"pay_required":false,"elapsed_ms":…}——生成结果的正文在result.content（完整 markdown 文本，直接呈现给用户即可）；付费技能首次调用返回 HTTP 402（见下文「支付流程」），非 402 的失败见响应体error枚举
签名算法
以密钥 f77875b168c395bb50b70a465bce1e12c0de614abf7d6b518a4565099c648da4 对字符串 apiKey.timestamp.nonce.rawBody（四段以英文句点拼接，rawBody 为请求体原文）计算 HMAC-SHA256，取十六进制小写作为 X-Signature。
curl 示例（占位符由发布方在部署时替换）
curl -X POST "https://teacheronhand.com/api/open/skillhub-run.php"
-H "Content-Type: application/json"
-H "X-Api-Key: 9fc70c3c4f0b0496c0b71bea666af159a66c2b29dcae6014"
-H "X-Timestamp: 1760000000"
-H "X-Nonce: 6b1f0c2ad4e83f57"
-H "X-Signature: <按上述签名算法计算>"
-d '{"skill":"AI学习诊断报告","skill_id":"qiyan-report-read","params":{"stage_subject":"高一数学","learn_data":"近三次单元测成绩 + 作业完成情况 + 课堂互动记录","cycle":"单元后诊断","report_focus":"重点诊断策略迁移力和元认知水平"}}'支付流程（X402 · 微信支付）
本技能为付费技能（Pay Skill），按次计费：单次 ¥5。支付遵循 X402 协议，在对话内完成，无需跳转支付页面。
支付时序（请严格按此执行）
- 前置检查：发起付费调用前，先确认运行环境已安装 weixinpay 插件（
weixinpay_pay工具可用）；未安装时引导用户安装或启用该插件后再继续，不要在插件缺失时发起付费请求。 - 首次调用：按上文调用示例发起请求（此时不带
pay_token）。 - 处理 402：返回 HTTP 402 表示本次调用需要支付。响应头
WeixinPay-Required与响应体payment.payment_code均为本次支付的 paymentCode（响应体WeixinPay提示块含相同指引）。 - 申请支付授权：将 paymentCode 作为参数交给
weixinpay_pay工具，向用户申请支付授权；用户在微信内确认支付。 - 支付完成后重试：在原请求体中加入
"pay_token": "<响应体 payment.pay_token>"字段重新调用本接口；服务端验单通过后返回{"ok":true,…}的正式结果。 - 仍返回 402 时：说明支付尚未到账或已超时，稍候重试即可；若
payment_code已过期（有效期约 15 分钟，见payment.expires_at），新一次 402 会自动携带新的 paymentCode 与 pay_token。
要点
- weixinpay 插件是微信支付能力的载体，插件缺失时整个支付流程无法完成——前置检查未通过就先引导安装，不要继续发起调用。
- 一次支付对应一次执行：
pay_token是本次支付的凭据，重试时务必带上，不要换用其他值。 - 应付金额以响应体
payment.amount为准（人民币，元）。 - 未支付时不要向用户展示生成结果（服务端尚未放行执行）。
- 用户明确拒绝支付时礼貌停止，不要反复催付。
结果呈现规范
拿到接口返回后，请按以下方式呈现给用户：
- 先说一句是什么：用一两句大白话告诉用户拿到了什么（如「分析出来了，孩子主要是审题环节丢分，下面有具体建议」）。
- 完整呈现正文：
result.content是完整的 markdown 结果，请完整交给用户，不要截断、不要省略中段。 - 可以润色排版：允许也鼓励做这些——调整排版与层级、给关键结论加粗、在开头补一段要点小结、按用户要求变换形式（如把对照内容整理成表格）。
- 不改专业内容：判级结论、评分依据、教案步骤、练习内容等，一律原样保留，不得改写、删减或「优化」。
- 收尾加边界句：结尾附一句「以上内容由 AI 生成，仅供参考」+ 下述使用边界。
计费说明
本技能为付费技能（Pay Skill），按次计费：单次 ¥5。支付在对话内经 X402 协议完成（见上文「支付流程」），无需跳转支付页面。
使用边界
生成内容由人工智能辅助生成，仅供参考。请家长结合孩子实际情况判断取舍；重要教育决定建议与老师沟通。
