SuperAPI AI 工具集

ielts-listening-review

通用与其它

查看项目

更新于 10-15 23:33

技能介绍

用途:本 Skill 仅说明如何读取 IELTS Buddy 中已提交练习的数据,不定义听力诊断、精听或教学课程方案。服务端返回事实数据,不定位证据、判断错因或生成训练建议。

主要能力:ielts_review_read_snapshot 读取已提交 session 的题目编号、题型、题干、用户作答、答案 key 与可选材料快照;ielts_review_recent_activity 返回已提交普通练习和已完成模考科目的摘要及复盘引用;ielts_practice_read_session 查看未提交练习的 session 状态和浏览器入口;ielts_dictation_search_materials 只读列出可逐句精听的素材、分组标签、句段数和计划 contentRef,不会创建精听运行或打开页面。

使用方式:先按 Agent API 配置绑定账号并检查能力,如执行 python3 scripts/ielts_buddy_api.py capabilities。查询记录分两步:先读列表摘要,再用返回的 reviewTarget 调用详情。示例:python3 scripts/ielts_buddy_api.py call ielts_review_read_snapshot --json '{"target":{"kind":"practice","sessionId":123},"scope":"incorrect","includeMaterial":false}'。精听使用 attemptId 调用 ielts_dictation_read_attempt;未提交普通练习用 sessionId 调用 ielts_practice_read_session。

适用场景与限制:正式作答、播放和提交须在浏览器练习页完成。区分零作答、已作答未提交和已提交,不从部分题目正确率推算 IELTS 分数。需完整记录时按 nextOffset、nextCursor 或 nextPage 翻页直至 hasMore=false;空页有后续游标时仍需继续。observationTruncated=true 或 coverage.sourceTruncated=true 表示数据不完整,不得声称查全。列表中的 sessionId 是练习次数,partId 是不同篇目。足迹接口使用 ielts_footprints_list,直接读取服务端 summary 等字段,不能用本页 activities 长度重算历史总量、热力图、连续天数及本周次数;分页时原样传递 nextCursor,保持 kinds/query/timeRange 不变。统计范围为 filtered_history,时区 Asia/Shanghai,每日计数覆盖至 asOf 当日 28 天。ielts_learning_pull_events 的 cursor 与足迹字符串 cursor 不可互换,条数不可直接比较。使用前以当前账号 capabilities 为准;workflows/ 为独立可选推荐层,不属于本 Skill 接口契约。