# IELTS Buddy Agent Skills

基于“躺着学”雅思教研团队长期教学与学员服务实践整理的 IELTS Agent Skills，持续维护中。面向 Codex、Claude Code、Cursor、WorkBuddy 等本地 Agent，每个 Skill 都可独立安装；安装全套后，Agent 会按任务选择合适的 Skill。

> 本仓库只分发 Agent Skills。面向网页 AI 的提示词、效果说明与使用引导，请前往 [IELTS Buddy 技能商店](https://ieltsbuddy.igopx.cn/skills)。

## 安装

需要 Node.js 18+。先查看可安装项：

```sh npx skills@latest add Jobo16/ielts-buddy --list ```

安装全套：

```sh npx skills@latest add Jobo16/ielts-buddy --skill '*' --global --yes ```

安装一个 Skill：

```sh npx skills@latest add Jobo16/ielts-buddy --skill ielts-writing-review --global --yes ```

安装完成后可以直接描述你的学习任务，或明确说“使用 `$ielts-writing-review` 批改这篇作文”。

## 更新

通过 `skills` 安装的学习 Skill 会保存其 GitHub 来源。网络稳定时，可以继续使用 GitHub 更新：

```sh # 更新全局安装的 IELTS Buddy Skills npx skills@latest update ielts-study-plan ielts-practice ielts-writing-review ielts-speaking-coach ielts-reading-review ielts-listening-review ielts-vocabulary-coach ielts-mock-review --global --yes ```

在项目内安装时，将 `--global` 改为 `--project`。也可以执行 `npx skills@latest update --global --yes` 更新所有可更新的全局 Skill。

更新只在用户或 Agent 明确执行上述命令时进行；Skill 不会在运行期间静默改写本地文件。

### OSS 更新（网络不稳定时优先使用）

每次 GitHub Release 都会同步生成一份固定 commit、版本和 SHA-256 的 OSS 完整发行包。安装 `ielts-buddy-skills-updater` 后，检查和更新不再依赖 GitHub：

```sh python3 scripts/update_skills.py check python3 scripts/update_skills.py update ```

固定入口：

```text https://ieltsbuddy-content.oss-cn-hangzhou.aliyuncs.com/learner-skills/latest.json https://ieltsbuddy-content.oss-cn-hangzhou.aliyuncs.com/learner-skills/ielts-buddy-agent-skills.zip ```

如果尚未安装更新 Skill，可以从上面的 OSS ZIP 下载完整包，再用本地目录安装：

```sh npx skills@latest add ./ielts-buddy-agent-skills --skill '*' --global --yes ```

## 版本

仓库根目录的 [`manifest.json`](manifest.json) 是全套 Skills 的唯一版本来源。每次发布均在 GitHub 创建与该版本严格一致的 `v<version>` tag；发布工作流会校验两者一致，生成 GitHub Release，并同步更新 OSS 的不可变 release、稳定 ZIP 和 `latest.json`。GitHub 是维护真源，OSS 是面向用户的默认下载和更新源。

## 内容来源与维护

本仓库基于“躺着学”雅思教研团队长期教学与学员服务实践整理，并结合 IELTS Buddy 的学习工作流持续维护。内容会随着教研复盘和产品能力更新而调整，版本变更以仓库记录为准。

这些 Skills 是学习辅助工具，不替代教师