ielts-buddy
连接 IELTS Buddy 账号、查询课程和真实学习记录、分析学习快照,或按用户要求保存待办、词书与口语素材时使用。只需处理用户已提供材料的学习任务无需连接。
SKILL.mdskills/ielts-buddy/SKILL.md
GitHub连接 IELTS Buddy 学习数据
使用用户当前任务所需的最少数据。HTTP 接入的实时事实源是 Agent 接入说明,逐接口参数以运行环境返回的文档为准,不猜测操作名或调用站内私有接口。
连接与调用
- 已有授权时复用凭据,先通过
GET /api/v1/agent/me核对账号、有效期和 scopes。没有授权且任务需要个人数据时,在本 Skill 根目录运行python3 scripts/ielts_buddy_api.py bind,仅将返回的绑定链接交给用户确认;不要代替用户确认或索要密码、Cookie。 - 运行
python3 scripts/ielts_buddy_api.py capabilities,再 GET 所需/capabilities/<operation>.md阅读请求、权限与响应。也可直接使用 Agent 自带 HTTP 能力。 - 使用
python3 scripts/ielts_buddy_api.py call <operation> --json '<JSON>'。长请求使用--json -从标准输入读取。执行时将脚本路径解析为本 Skill 安装目录下的绝对路径。 - 检查 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。