下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-awzs0xyg--qiyan-open-grade.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-awzs0xyg/qiyan-open-grade。开放题怎么给分?贴上学生答案,按 SOLO 分类理论判定思维层级并给出评语——知识点罗列还是深度思考,反馈一针见血,分层教学有据
阅读全文 (展开查看完整说明)
概述
这是什么
开放题判分专家:按思维层级(SOLO) —— 开放题怎么给分?贴上学生答案,按 SOLO 分类理论判定思维层级并给出评语——知识点罗列还是深度思考,反馈一针见血,分层教学有据
面向教师:备课、出题、判分、学情分析,这些最占时间的重复工作交给它;您只需核对与定稿,把时间还给课堂和学生。
方法论基础:SOLO 分类理论。
参数说明
使用时按下表准备信息(对话中提供、或调用接口时传入均可):
| 参数名 | 说明 | 必填 | 可选值 |
|---|---|---|---|
| subject | 学科 | 是 | 语文、数学、英语、物理、化学、生物、地理、历史、道德与法治、科学、信息技术、音乐、美术、体育与健康、劳动、综合实践、心理健康、通用技术、其他(高校/职教专业) |
| grade | 学段 | 是 | 小学低年级(1-2年级)、小学中年级(3-4年级)、小学高年级(5-6年级)、七年级、八年级、九年级、高一、高二、高三、中职、高职、高校 |
| topic | 题目 / 知识点(示例:浮力、守株待兔、一元二次方程、发动机怠速故障诊断) | 是 | — |
| answers | 学生作答。纸质作业可拍照后用微信「提取文字」转成文本再粘贴;每行一份,以「学生名称:」开头接作答内容,姓名可自定义(学生1、学生A、黄百合均可)(示例:学生1:……(姓名可自定义,如 黄百合:……)) | 是 | — |
所有参数均为纯文本。 用户提供的照片、扫描件(作文、试卷、错题、成绩单等)须先在本对话中完成识别、提取为完整文字,校对后作为纯文本传入——接口不接受图片,也不接受图片链接。
怎么用(对话式)
用户不需要了解参数名或接口。请以聊天方式帮用户收集信息,收集齐后自动完成调用:
- 一次只问一件事:按参数表的说明用大白话逐项询问(比如问学段就问「您教几年级」,不要说「请提供 grade 参数」)。
- 用户说不清时给选项:从参数表的「可选值」里挑 2–3 个常见的让用户点选,不要反复追问。
- 图片先转文字:用户直接发照片时(作文、试卷、错题、成绩单等),先在对话中识别图片、提取出完整文字内容,校对无误后把纯文本作为对应参数传入——接口只接受文字,不接受图片或图片链接。
- 边聊边记:用户聊天中顺口提到的信息(年级、学科等)直接记下,后面不要再问一遍。
- 收齐即调:必填项齐了就调用接口,不要让用户再确认一遍表格。
- 等待时告知:生成约需半分钟左右,调用前跟用户说一声「大概需要半分钟」。
调用示例
本技能的生成与执行均在服务端完成,对话侧只需按以下契约传入参数。
接口契约
- 请求:
POST https://teacheronhand.com/api/open/skillhub-run.php - 请求头:
Content-Type: application/json - 请求体:
{"skill":"<技能名>","skill_id":"<壳标识>","params":{…}}——skill填本技能引擎名「SOLO 分层诊断」,skill_id填qiyan-open-grade(支付按次凭据之一,务必原样携带),params见上文参数表;支付完成后重试时另加"pay_token":"<支付凭据>"(见下文「支付流程」) - 响应:成功
{"ok":true,"result":{"type":"solo","report":{…}},"pay_required":false,"elapsed_ms":…}——判分结果在result.report:results数组逐份作答给出level_name(思维层级)、wording(面向该生的评语建议)、rationale(判定依据),distribution为各层级人数分布;付费技能首次调用返回 HTTP 402(见下文「支付流程」),非 402 的失败见响应体error枚举
curl 示例
curl -X POST "https://teacheronhand.com/api/open/skillhub-run.php"
-H "Content-Type: application/json"
-d '{"skill":"SOLO 分层诊断","skill_id":"qiyan-open-grade","params":{"subject":"语文","grade":"小学低年级(1-2年级)","topic":"浮力","answers":"学生1:……"}}'支付流程(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.report.results逐份作答给出思维层级(level_name)与评语建议(wording),请逐份完整呈现、一份不落;result.report.distribution的各层级人数分布可整理成一行小结放在最前面。 - 可以润色排版:允许也鼓励做这些——调整排版与层级、给关键结论加粗、在开头补一段要点小结、按用户要求变换形式(如把对照内容整理成表格)。
- 不改专业内容:判级结论、评分依据、教案步骤、练习内容等,一律原样保留,不得改写、删减或「优化」。
- 收尾加边界句:结尾附一句「以上内容由 AI 生成,仅供参考」+ 下述使用边界。
计费说明
本技能为付费技能(Pay Skill),按次计费,价格以 SkillHub 平台展示为准。支付在对话内经 X402 协议完成(见上文「支付流程」),无需跳转支付页面。
使用边界
生成内容由人工智能辅助生成,仅供参考。教学使用前,请教师结合学情把关并修改后定稿。