SuperAPI AI 工具集

submit-weekly-quiz

通用与其它

查看项目

更新于 10-16 12:32

技能介绍

用途:把某一周的英语阅读测验内容提交到 zxkane/english-weekly-quiz 静态站点。该站点每周日发布一份 KET/PET 测验,发布机制即一个 JSON 文件加可选音视频与一个 PR。

主要能力:根据用户提供的短文段落和题目组装 JSON 测验文件,计算 ISO 周与对应周日(如 date.fromisocalendar(year, week, 7)),校验内容后创建 PR。触发器包括“submit this week's quiz”“publish the weekly quiz with these essays”“open a quiz PR for week 21”等。

使用方式:若无本地克隆则先 git clone https://github.com/zxkane/english-weekly-quiz.git,再 git checkout -b quiz/<week> 并 npm install。从模板复制 JSON 到 content/quizzes/<week>.json 后填写,运行 npm run validate-content 校验,最后用脚本或 gh pr create 开 PR。week 字段须与文件名一致,publishedAt 必须等于该 ISO 周的周日。可用脚本 bash <skill-dir>/scripts/iso-sunday.sh 计算,或 python 里 date.fromisocalendar。

结构要点:JSON 含 week、publishedAt、title、level(KET/PET/KET/PET)、tags、essay(paragraphs 支持字符串或 {text, image?}),questions 3–20 道,类型为 multiple_choice、true_false、fill_blank;id 形如 q1。可选 vocabulary 中每条必须有 translations.zh。音频放 public/audio/<week>/,图片放 public/images/<week>/,超声/超图大小会校验失败;也可用 https 外链。

限制:内容面向儿童,不得自动合并或直接推 main,必须经 PR 人工审阅,每个 PR 只含一周。校验器能查字段、周与日期匹配、选项答案一致性、文件存在与大小、题量、译注缺失等,但无法判断解释质量、干扰项是否合理、事实错误、音频与图片是否匹配。不要虚构字段,不要使用 http:// 链接。