ielts-speaking-coach git:20260829.ce9e546A

Immutable. This exact content is served forever at /api/v1/blob/c9412e416654654b.

---
name: ielts-speaking-coach
description: 说明如何读写当前账号的 IELTS Buddy 口语素材；不定义口语陪练、反馈或素材组织方法。
---

# IELTS Buddy 口语素材接口

本 Skill 只说明用户口语素材的读写接口。调用前，先按[Agent API 配置](references/setup.md)绑定并检查能力。

## 接口

| 能力 | 数据或动作 | 调用约束 |
| --- | --- | --- |
| `ielts_speaking_materials_search`、`ielts_speaking_materials_read` | 当前账号的口语素材目录与精确素材详情 | 仅读取当前账号数据。 |
| `ielts_speaking_materials_create`、`ielts_speaking_materials_update`、`ielts_speaking_materials_archive` | 创建、更新、归档用户确认的素材 | 题目关联仅在明确提供 `questionLinks` 时改变；修改故事不会触发隐藏匹配。 |

```sh
python3 scripts/ielts_buddy_api.py capabilities
python3 scripts/ielts_buddy_api.py call ielts_speaking_materials_search --json '{}'
```

## 边界

- 不把对话中的推断自动写成用户素材。
- 串题练习由用户在浏览器素材页手动开始；Agent 不创建正式练习 session。
- 本 Skill 不定义话题选择、回答反馈、评分或练习顺序。
- `workflows/` 是独立的可选推荐层，不属于本 Skill 的接口契约。