About ielts-listening-review
ielts-listening-review is a read-only data skill for IELTS Buddy listening practice. It lets agents query submitted practice, completed mock-test sections, and dictation materials, while distinguishing summaries from details and documenting data-coverage limits.
Key features
- 01Read submitted practice snapshots
- 02Query recent practice and mock-test summaries
- 03Check unsubmitted practice status
- 04Search dictation material catalog
- 05Check pagination and data completeness
Use cases
- 01Review answers and keys for a practice session
- 02Browse recent practice or mock-test records
- 03Verify whether practice was submitted
- 04Find materials for sentence-by-sentence dictation
MCP support
It calls read interfaces through IELTS Buddy Agent API capabilities; account binding and a capability check are required first.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/ielts-listening-reviewin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
manifest.jsonagents/openai.yamlreferences/setup.mdDetails
From the project READMEIELTS Buddy 听力结果接口
本 Skill 只说明已提交练习数据的读取方式。需要账号数据时，先按Agent API 配置绑定并检查能力。
接口
| 能力 | 数据 | 调用约束 |
|---|---|---|
ielts_review_read_snapshot | 已提交 session 的题目编号、题型、题干、用户作答、答案 key 与可选材料快照 | 只读取当前账号已提交的 session；仅需要原始材料时传 includeMaterial:true。 |
ielts_review_recent_activity | 已提交普通练习和已完成模考科目的摘要及复盘引用 | 先查列表，再将返回的 reviewTarget 作为详情工具的 target。 |
ielts_practice_read_session | session 状态和浏览器入口 | 仅需核实未提交普通练习时使用。 |
ielts_dictation_search_materials | 可逐句精听的听力素材、分组标签、句段数和计划 contentRef | 只读目录；不会创建精听运行或打开页面。 |
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":false}'
边界
- 服务端返回事实数据，不定位证据、不判断错因、不生成训练建议。
- 正式作答、播放和提交在浏览器练习页完成。
workflows/是独立的可选推荐层，不属于本 Skill 的接口契约。
列表与详情
查询学习记录分两步：先读取列表摘要，再按需用返回的 reviewTarget 调用 ielts_review_read_snapshot 查看某次练习或某个已完成模考科目的详情；精听使用 attemptId 调用 ielts_dictation_read_attempt，未提交普通练习使用 sessionId 调用 ielts_practice_read_session。不要为了列出记录逐条展开详情。使用前以当前账号的 capabilities 为准。
列表中的 sessionId 是练习次数，partId 是不同篇目；区分零作答、已作答未提交和已提交，不从部分题目的正确率推算 IELTS 分数。需要完整记录时按 nextOffset、nextCursor 或 nextPage 翻页，直到 hasMore=false；空页有后续游标时仍需继续。observationTruncated=true 或 coverage.sourceTruncated=true 表示数据仍不完整，不得声称查全。计划列表只含摘要，用 planId 调用 ielts_study_plans_get 获取任务页。
足迹与学习统计
跨产品活动使用 ielts_footprints_list。直接读取服务端 summary、dailyCounts、todayCounts 和 total；activities 只是本页，不能用它的长度或日期分布重算历史总量、热力图、连续天数及本周次数。只查询统计时无需拉完时间线。
足迹优先将 nextCursor 原样作为下一次请求的 cursor，保持 kinds/query/timeRange 不变。统计范围是 statisticsScope=filtered_history，时区是 Asia/Shanghai，每日计数覆盖截至 asOf 所在日的 28 天。同章节同日的视频进度折叠为一次展示活动，原始事件保留。
ielts_learning_pull_events 同步的是原始学习证据，数字 cursor 与足迹的字符串 cursor 不可互换，两者条数也不应直接比较。网页未显示记录时，先核对分页和覆盖范围，不用 ielts_learning_push_events 补写已经存在的事实。返回缺失字段或 coverage.sourceTruncated=true 时保持“不完整”的结论，以当前部署的足迹接口文档为准。