用途:读取 IELTS Buddy 已提交阅读练习的结果与按需材料,以及最近活动和学习统计;不定义证据分析、错因判断或教学方案。
主要接口:ielts_review_read_snapshot 读取已提交 session 的题目编号、题型、题干、用户作答、答案 key 与可选材料快照,仅限当前账号已提交 session,需要原始材料时传 includeMaterial:true;ielts_review_recent_activity 返回已提交普通练习和已完成模考科目摘要及复盘引用;ielts_practice_read_session 查未提交普通练习的 session 状态与浏览器入口。
用法:先绑定 Agent API 并检查能力:python3 scripts/ielts_buddy_api.py capabilities;再按需调用,如 python3 scripts/ielts_buddy_api.py call ielts_review_read_snapshot --json '{"target":{"kind":"practice","sessionId":123},"scope":"incorrect","includeMaterial":true}'。查记录先读列表摘要,再用 reviewTarget 调详情。
列表与分页:sessionId 是练习次数,partId 是篇目;区分零作答、已作答未提交和已提交,不从部分题目正确率推算 IELTS 分数。按 nextOffset、nextCursor 或 nextPage 翻页到 hasMore=false,空页有后续游标仍继续。observationTruncated=true 或 coverage.sourceTruncated=true 表示不完整,不得声称查全。
足迹与统计:跨产品活动使用 ielts_footprints_list,直接读取 summary、dailyCounts、todayCounts、total,不用 activities 长度重算历史总量。足迹将 nextCursor 原样作为下次 cursor,保持 kinds/query/timeRange 不变;统计范围为 filtered_history,时区 Asia/Shanghai,每日计数覆盖截至 asOf 所在日 28 天。ielts_learning_pull_events 的原始证据与足迹 cursor 不可互换,也不应直接比较条数。
限制:服务端只返回事实数据,不定位原文证据、不判断错因、不生成词汇或训练建议;正式作答与提交在浏览器练习页完成;workflows/ 为独立可选推荐层,不属于本 Skill 接口契约。使用前以当前账号 capabilities 为准。