ielts-buddy

连接 IELTS Buddy 账号、查询课程和真实学习记录、分析学习快照,或按用户要求保存待办、词书与口语素材时使用。只需处理用户已提供材料的学习任务无需连接。

SKILL.md

GitHub

连接 IELTS Buddy 学习数据

使用用户当前任务所需的最少数据。HTTP 接入的实时事实源是 Agent 接入说明,逐接口参数以运行环境返回的文档为准,不猜测操作名或调用站内私有接口。

连接与调用

  1. 已有授权时复用凭据,先通过 GET /api/v1/agent/me 核对账号、有效期和 scopes。没有授权且任务需要个人数据时,在本 Skill 根目录运行 python3 scripts/ielts_buddy_api.py bind,仅将返回的绑定链接交给用户确认;不要代替用户确认或索要密码、Cookie。
  2. 运行 python3 scripts/ielts_buddy_api.py capabilities,再 GET 所需 /capabilities/<operation>.md 阅读请求、权限与响应。也可直接使用 Agent 自带 HTTP 能力。
  3. 使用 python3 scripts/ielts_buddy_api.py call <operation> --json '<JSON>'。长请求使用 --json - 从标准输入读取。执行时将脚本路径解析为本 Skill 安装目录下的绝对路径。
  4. 检查 HTTP 与业务 code;写入成功后引用返回的 id 和事实,必要时读回。401 重新绑定;403 核对 scopes,不能通过网页 Cookie 绕过权限。已有绑定不代表用户授权发送反馈或进行无关写入。

按任务取数

  • 跨模块学习分析:优先 学习快照与证据,读取快照目录后在本地查询需要的记录,不打印整包。
  • 查最近一次练习、模考科目或精听结果:使用 复盘记录,先列表再详情;只查统计时使用足迹 summary,不累加分页行数。
  • 查课程、题目、资料:从当前 capability 目录选择,复用服务端返回的精确 id、contentRef 和链接。正式作答、播放、看课、交卷由用户在网页完成。
  • 保存学习安排:ielts_study_todos_create/update,日期、时间和内容关联均按当前契约;明确要求安排时直接执行,讨论建议时不写。打开链接不等于完成待办。
  • 保存词句:ielts_vocabulary_add,由调用方提供释义,保存不代表网站产生复习成绩。
  • 保存口语素材:只提交标题和真实经历,不保存题目覆盖映射。
  • 用户明确要求发送产品反馈时才用 ielts_feedback_create;响应不确定先读取 ielts_feedback_list 核对,不能盲目重发。

教学判断在调用方完成。站内文档创作、实时语音等未列入公开契约的功能,不作为本 Skill 能力。后台题库研究需要独立 Operator 权限与工具,用户 Token 不可代替 Operator Token。