下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-awzs0xyg--qiyan-class-report.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-awzs0xyg/qiyan-class-report。考完试别只看平均分。贴上班级成绩与学习数据,生成学情诊断报告:谁在掉队、谁吃不饱、分层教学怎么分、下节课怎么讲——建议直接可用
阅读全文 (展开查看完整说明)
概述
这是什么
学情诊断报告专家 —— 考完试别只看平均分。贴上班级成绩与学习数据,生成学情诊断报告:谁在掉队、谁吃不饱、分层教学怎么分、下节课怎么讲——建议直接可用
面向教师:备课、出题、判分、学情分析,这些最占时间的重复工作交给它;您只需核对与定稿,把时间还给课堂和学生。
参数说明
使用时按下表准备信息(对话中提供、或调用接口时传入均可):
| 参数名 | 说明 | 必填 | 可选值 |
|---|---|---|---|
| stage_subject | 学段与学科(示例:高一数学 / 六年级英语) | 是 | — |
| learn_data | 学生学习数据(示例:近三次单元测成绩 + 作业完成情况 + 课堂互动记录 / 期中测成绩 + 错题本记录) | 是 | — |
| cycle | 诊断周期 | 是 | 单元后诊断、月度诊断、期中/期末诊断、学期末总诊断 |
| report_focus | 报告重点(示例:重点诊断策略迁移力和元认知水平 / 重点诊断情感投入度变化趋势) | 是 | — |
| audience | 报告使用对象 | 否 | 仅教师自己看、给学生本人看、给家长看、三者都看 |
所有参数均为纯文本。 用户提供的照片、扫描件(作文、试卷、错题、成绩单等)须先在本对话中完成识别、提取为完整文字,校对后作为纯文本传入——接口不接受图片,也不接受图片链接。
怎么用(对话式)
用户不需要了解参数名或接口。请以聊天方式帮用户收集信息,收集齐后自动完成调用:
- 一次只问一件事:按参数表的说明用大白话逐项询问(比如问学段就问「您教几年级」,不要说「请提供 grade 参数」)。
- 用户说不清时给选项:从参数表的「可选值」里挑 2–3 个常见的让用户点选,不要反复追问。
- 图片先转文字:用户直接发照片时(作文、试卷、错题、成绩单等),先在对话中识别图片、提取出完整文字内容,校对无误后把纯文本作为对应参数传入——接口只接受文字,不接受图片或图片链接。
- 边聊边记:用户聊天中顺口提到的信息(年级、学科等)直接记下,后面不要再问一遍。
- 收齐即调:必填项齐了就调用接口,不要让用户再确认一遍表格。
- 等待时告知:生成约需半分钟左右,调用前跟用户说一声「大概需要半分钟」。
调用示例
本技能的生成与执行均在服务端完成,对话侧只需按以下契约传入参数。
接口契约
- 请求:
POST https://teacheronhand.com/api/open/skillhub-run.php - 请求头:
Content-Type: application/json - 请求体:
{"skill":"<技能名>","skill_id":"<壳标识>","params":{…}}——skill填本技能引擎名「AI学习诊断报告」,skill_id填qiyan-class-report(支付按次凭据之一,务必原样携带),params见上文参数表;支付完成后重试时另加"pay_token":"<支付凭据>"(见下文「支付流程」) - 响应:成功
{"ok":true,"result":{"type":"text","content":"…"},"pay_required":false,"elapsed_ms":…}——生成结果的正文在result.content(完整 markdown 文本,直接呈现给用户即可);付费技能首次调用返回 HTTP 402(见下文「支付流程」),非 402 的失败见响应体error枚举
curl 示例
curl -X POST "https://teacheronhand.com/api/open/skillhub-run.php"
-H "Content-Type: application/json"
-d '{"skill":"AI学习诊断报告","skill_id":"qiyan-class-report","params":{"stage_subject":"高一数学","learn_data":"近三次单元测成绩 + 作业完成情况 + 课堂互动记录","cycle":"单元后诊断","report_focus":"重点诊断策略迁移力和元认知水平"}}'支付流程(X402 · 微信支付)
本技能为付费技能(Pay Skill),按次计费,价格以 SkillHub 平台展示为准。支付遵循 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),按次计费,价格以 SkillHub 平台展示为准。支付在对话内经 X402 协议完成(见上文「支付流程」),无需跳转支付页面。
使用边界
生成内容由人工智能辅助生成,仅供参考。教学使用前,请教师结合学情把关并修改后定稿。