本 Skill 描述 IELTS Buddy 的学习数据接口,供调用方读取与写入已确认的学习数据。使用前先按 Agent API 配置绑定,并检查当前账号实际可用的能力(python3 scripts/ielts_buddy_api.py capabilities)。
用途与能力:接口涵盖计划读写、内容发现、提醒配置、学习路径与画像、资源关联、学习事件记录等。例如读取计划使用 ielts_study_plans_list 与 ielts_study_plans_get;发现可写入内容使用 ielts_courses_search_sections、ielts_practice_search_parts、ielts_dictation_search_materials、ielts_mock_search_papers;创建计划使用 ielts_study_plans_create;修改使用 ielts_study_plans_update、change_tasks、replan、delete;提醒使用 ielts_notifications_get_status 与 ielts_notifications_configure_wechat_task_reminders。
必要用法:读取计划时使用返回的精确 planId、任务 ID 与 revision,不猜 ID;创建任务必须包含服务端返回的 contentRef、中国日历日期,以及 morning、afternoon 或 evening 时段。contentRef 只接受 practice_part、mock_paper、course_section 或 listening_dictation,应直接复用目录工具返回的对象。修改标题或目标使用 update,改变任务使用 change_tasks,整体替换未完成任务使用 replan,不要混用。写入前先读取计划;只有写入接口成功后,才能声称已创建或修改。
学习记录查询分两步:先读列表摘要,再按需用 reviewTarget 调用 ielts_review_read_snapshot 查看详情;精听用 attemptId 调用 ielts_dictation_read_attempt,未提交练习用 sessionId 调用 ielts_practice_read_session。跨产品活动使用 ielts_footprints_list,直接读取服务端 summary、dailyCounts、todayCounts 和 total,不用单页 activities 重算历史总量;按 nextCursor 原样翻页并保持 kinds/query/timeRange 不变。统计范围为 statisticsScope=filtered_history,时区 Asia/Shanghai,每日计数覆盖截至 asOf 所在日的 28 天。
限制:计划目标、优先级与任务内容由调用方与用户决定,服务端只保存经确认的数据。描述已保存计划时以接口最近返回的实际任务、日期、时段、时长和状态为准,不把草案或推测说成事实;分页结果不代表完整计划,hasMore=false 前需继续翻页,空页有后续游标仍需继续;observationTruncated 或 coverage.sourceTruncated 为真表示数据不完整,不得声称查全。缺失字段保持未知,不补造数据;不把建议、草案或推断写入事件。workflows/ 为独立可选推荐层,不属于本 Skill 接口契约。