git:20260818.2af13fc to git:20260821.c64c55c

18 added, 15 removed. Audit A to A.

---

name: ielts-speaking-coach

- description: Run IELTS Speaking Part 1, Part 2, or Part 3 coaching, map real personal stories to cue-card coverage, build reusable topic material, and generate a validated speaking report. Use when a learner asks for speaking practice, mock interview feedback, transcript review, topic selection, topic coverage, answer development, reusable phrases, or a speaking DOCX report.

+ description: 说明如何读写当前账号的 IELTS Buddy 口语素材和练习入口；不定义口语陪练、反馈或素材组织方法。

---

- # IELTS 口语陪练

+ # IELTS Buddy 口语素材接口

- 默认用简体中文反馈；题目、英文回答、改写和表达块保留英文。每次只问一个问题，等学习者回答后再反馈。没有音频证据时，不评价发音。

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

- ## 选择工作流

+ ## 接口

- | 需求 | 读取 |

- | --- | --- |

- | Part 1/2/3 问答、转写反馈、口语报告 | [口语教练](workflows/speaking-coach/WORKFLOW.md) |

- | 串题、故事线、题目选择和表达素材 | [话题素材](workflows/speaking-topic-builder/WORKFLOW.md) |

- | 用真实经历覆盖一批 Part 2 题目、找出缺口 | [口语覆盖图](workflows/speaking-coverage-map/WORKFLOW.md) |

+ | 能力 | 数据或动作 | 调用约束 |

+ | --- | --- | --- |

+ | `ielts_speaking_materials_list` | 当前账号的口语素材目录 | 仅读取当前账号数据。 |

+ | `ielts_speaking_materials_create`、`ielts_speaking_materials_update`、`ielts_speaking_materials_archive` | 创建、更新、归档用户确认的素材 | 仅提交用户明确确认的内容。 |

+ | `ielts_speaking_materials_start_practice` | 指定素材的练习入口 | 原样使用服务端返回入口，不自行拼接 URL。 |

- ## 执行要求

+ ```sh

+ python3 scripts/ielts_buddy_api.py capabilities

+ python3 scripts/ielts_buddy_api.py call ielts_speaking_materials_list --json '{}'

+ ```

- - 先判断练习 Part、目标分和可用材料；反馈优先处理内容展开、流利连贯、词汇和语法。

- - 只纠正最影响表现的 1–3 个问题，并给出自然替代表达与下一题。

- - 学习者想保存本次自然表达时，读取 [词汇交接](references/vocabulary-handoff.md)；先筛选并让学习者确认，再写入个人词汇本。

- - 需要题库话题或保存学习结果时，先读 [Agent API 配置](references/setup.md)；题目选择和教学判断始终由本地 Agent 完成。

- - 全题、转写或完整模拟默认交付已验证的 DOCX；快速 Part 1 可直接在对话中完成。

+ ## 边界

+ - 不把对话中的推断自动写成用户素材。

+ - 本 Skill 不定义话题选择、回答反馈、评分或练习顺序。

+ - `workflows/` 是独立的可选推荐层，不属于本 Skill 的接口契约。