ielts-vocabulary-coach · diff
git:20260829.ce9e546 to git:20261102.e63f8f4
6 added, 21 removed. Audit A to A.
---
name: ielts-vocabulary-coach
- description: 说明如何读取、维护、导入导出和记录 IELTS Buddy 内置或个人词汇数据；不定义词汇教学或复习策略。
+ description: 用用户提供或真实收藏的少量词语、词块和句子开展主动回忆、搭配、提示与本轮复测，并按要求查询或维护 IELTS Buddy 我的词书。
---
- # IELTS Buddy 词汇数据接口
-
- 本 Skill 只说明词汇数据接口。调用前，先按[Agent API 配置](references/setup.md)绑定并检查能力。
-
- ## 接口
+ # 雅思词句训练
- | 能力组 | 数据或动作 | 调用约束 |
- | --- | --- | --- |
- | `ielts_vocabulary_builtin_prepare_cards`、`ielts_vocabulary_builtin_progress`、`ielts_vocabulary_builtin_record_review` | 内置词书卡片与复习进度 | 仅记录实际完成的复习结果。 |
- | `ielts_vocabulary_personal_search`、`ielts_vocabulary_personal_prepare_cards`、`ielts_vocabulary_personal_progress` | 当前账号个人词汇数据 | 仅读取当前账号数据。 |
- | `ielts_vocabulary_personal_add`、`ielts_vocabulary_personal_update`、`ielts_vocabulary_personal_delete`、`ielts_vocabulary_personal_import`、`ielts_vocabulary_personal_export` | 个人词汇维护与迁移 | 写入、删除或导入前须取得用户明确确认。 |
- | `ielts_vocabulary_personal_record_review` | 实际完成的个人词汇复习结果 | 不将推荐或推断记作复习。 |
+ 选少量与当前学习任务相关的表达，先让用户回忆或造句，再给提示、解释和换语境复测。根据本轮实际回答调整，不预先假定熟练度。方法见 [词句训练](references/vocabulary-session/WORKFLOW.md)。
- ```sh
- python3 scripts/ielts_buddy_api.py capabilities
- python3 scripts/ielts_buddy_api.py call ielts_vocabulary_personal_search --json '{}'
- ```
+ 用户材料可直接使用。需要个人词书时按 [数据接入](references/api-access.md)，具体读写见 [我的词书](references/vocabulary.md)。当前 API 为 search/add/update/delete，支持词语与句子，释义由调用方提供。查询按 nextOffset 续页；修改删除使用返回的完整 id，不自己拼 id。
- ## 边界
+ 用户说“保存这三句”时直接保存；只是在练习时不自动收藏。重复添加可能更新非空释义，先核对用户意图。网站没有对外的 due/new/weak 队列或复习成绩写入接口；本轮测验反馈只能描述本轮表现，不能说已更新网站复习进度。
- - 仅迁移词汇内容，不推断或迁移未证实的复习进度。
- - `update` 只修改词条内容；学习状态只能由实际 `record_review` 结果推进。
- - 本 Skill 不定义出题、提示、反馈或复习频率。
- - `workflows/` 是独立的可选推荐层，不属于本 Skill 的接口契约。
+ 用户要可打印练习表时，使用本 Skill 的 `scripts/vocabulary-session/` 生成并验证 DOCX；普通训练保持对话，不自动制作周计划或报告。