前言¶
做在线课堂的老师和教研,手里通常有一批现成的试卷、练习卷,题型是单选、多选、判断。要把这些题搬进 QuickClass 当作业,常见做法是人工逐题敲进后台,或者写脚本解析文档再拼 JSON,两次都要对着题干和选项核对,出错率不低。
下面介绍的是一个 Skill:QuickClass作业转换器。它把这条链路压缩成一步——给一份试卷(Word/PDF/图片)或学习材料,产出 QuickClass 能识别的作业 JSON。前面省下的手工录入时间,就是它解决的问题。
这是什么¶
QuickClass作业转换器是一个面向教育场景的转换类 Skill,坐标 @user_d101a129/quickclass-quiz-converter,当前版本 1.0.1,来源为 community(社区发布),由发布者 user_d101a129 维护,SkillHub 分类为 education。
它做的事只有一件:把试卷、试题、学习材料等输入,转换为 QuickClass 支持的作业格式,输入可以是文档、PDF、图片。
版本、来源、分类这类信息以 SkillHub 页面为准;页面上没有列出作者的其他背景,这里不做延伸。
核心功能¶
已核实的能力:
- 输入类型支持文档(Word)、PDF、图片。
- 输出为 QuickClass 支持的作业 JSON。
- 支持三种题型:
SINGLE_CHOICE(单选)、MULTIPLE_CHOICE(多选)、TRUE_FALSE(判断)。 - 标签显示
requires_api_key=false,按 SkillHub 页面标注,使用该 Skill 不需要单独的 API Key。
Skill 的触发条件和不触发边界,官方描述写得很明确,调用时要照着走:
- 用户想生成 QuickClass 作业 JSON,或提到 QuickClass / 课堂作业 / 题目转换 / 试卷转 JSON 时,应触发该 Skill。
- 用户只是想查看或理解 JSON 结构、从 JSON 反向导出、或只讨论教学内容而不生成作业时,不应触发。
这条边界的意义在于:它不是「能转 JSON」的通用工具,而是「为 QuickClass 作业生成 JSON」的专用工具。拿来做别的解析,属于误触发。
安装与启用¶
SkillHub 页面未列出单独的安装命令或配置字段。这类基于通用 SKILL.md 格式的 Skill,一般通过 SkillHub 获取后由宿主在对话中识别触发,具体入口以 SkillHub 页面为准。页面标注的 requires_api_key=false,即没有需要填的密钥项。
按官方给出的触发条件启用即可:当需求是生成 QuickClass 作业 JSON,或对话里出现 QuickClass / 课堂作业 / 题目转换 / 试卷转 JSON 这些关键词时,交给该 Skill 处理。
典型用法¶
官方资料给出的可复现示例是「把试卷、试题、学习材料等转换为 quickclass 支持的作业格式,支持文档、pdf、图片等」。据此,使用路径如下:
1、准备输入:试卷、试题或学习材料,格式为 Word 文档、PDF 或图片。
2、发起需求:说明要生成 QuickClass 作业 JSON,或直接提到题目转换、试卷转 JSON。
3、接收输出:QuickClass 支持的作业 JSON,题型落在 SINGLE_CHOICE、MULTIPLE_CHOICE、TRUE_FALSE 三类。
页面没有给出具体的输入样例文件和输出 JSON 片段,这里不做补写,以免与官方资料不符。
适用场景与注意¶
适合谁:
- 使用 QuickClass 布置课堂作业、考试或练习题的老师、教研和助教。
- 需要把纸质或电子版题库批量搬进 QuickClass 的人。
- 手上只有试卷图片或 PDF,希望直接产出作业 JSON 的场景。
限制与坑:
- 题型只覆盖单选、多选、判断。填空、简答等题型不在支持范围内,遇到这类题需要先改成支持的题型或另行处理。
- 识别质量取决于输入文档和图片本身的清晰度,扫描件模糊、排版混乱会直接影响提取结果,转换后仍需逐题核对题干与选项。
- 注意触发边界:只是想看 JSON 结构、从 JSON 反向导出、或讨论教学内容而不生成作业时,不要用这个 Skill。
- 该 Skill 标注
requires_api_key=false,即不涉及额外密钥。
结尾¶
QuickClass作业转换器把「试卷 → 作业 JSON」这一步固定下来,输入文档、PDF 或图片,输出三种题型的 QuickClass 作业 JSON,省掉手工录入和自写解析脚本的成本,但提取结果仍需人工核对。
官方地址:https://api.skillhub.cn/user_d101a129/quickclass-quiz-converter
SkillHub 页面:https://www.skillhub.cn/skills/user_d101a129/quickclass-quiz-converter