这个仓库是什么

这个仓库打包了两个 IELTS 写作批改 skills,让 AI agent 不只是给泛泛建议,而是按照接近真实老师的方式完成一整套批改流程:识别题目和学生原文、插入 Word 真批注、给出官方评分维度、添加局部精修改写,并生成对应的高质量范文。

默认目标水平:斜体改写稳定 Band 7.5,结尾范文稳定 Band 8.0。 如果你不额外指定目标分,两个 skill 都会默认把局部 italic rewrite 校准到稳定 7.5,把最后的 model answer / model essay 校准到稳定 8.0。你也可以在 prompt 里写 Target band: 7.5Target band: 8.0 等,让 agent 按你的目标分调整反馈重点。

Skill 适合场景 默认输出
$ielts-task1-review Academic Task 1 图表、表格、地图、流程图、混合图 带 Word 批注的 reviewed DOCX、评分、反馈、稳定 Band 7.5 斜体改写、4 段 Band 8.0 范文
$ielts-task2-review Task 2 观点类、讨论类、问题解决类、利弊类、混合类作文 带 Word 批注的 reviewed DOCX、评分、反馈、稳定 Band 7.5 斜体改写、4 段 Band 8.0 范文

输入文件要求

请使用未批改过的 .docx 作为输入。Reviewed 文件只适合作为效果预览,不要再拿 reviewed 文件重复批改。

类型 Word 文档中应该怎么放 不要这样放
Task 1 题目文字放在最前面;图表/地图/流程图作为 Word 内嵌图片放在题目后;学生答案放在图片后,并用正常段落分开 不要把学生答案放在图片前;不要缺少图表;不要把评分、范文或旧批注混进输入文件
Task 2 题目完整放在最前面;如果有 outline,可以放在题目后、正式作文前;正式作文放在最后,并用正常段落分开 不要把题目放在作文后;不要把 outline 当成正式作文;不要把旧反馈、范文或 reviewed 内容放进输入文件

这些位置很重要,因为 skill 会先区分题目、图片、outline 和学生正文,再把 Word comments 锚定到学生正文段落上。

示例文件

仓库的 examples/ 目录包含一组 Task 1 和 Task 2 示例。未带 (reviewed) 的文件是输入示例,带 (reviewed) 的文件是批改后效果预览。

示例 文件
Task 1 输入 C19T4 Writing Task 1.docx
Task 1 reviewed 输出 C19T4 Writing Task 1(reviewed).docx.docx>)
Task 2 输入 C19T4 Writing Task 2.docx
Task 2 reviewed 输出 C19T4 Writing Task 2(reviewed).docx.docx>)

核心亮点

真实批改体验 IELTS 内置知识 Agent 友好
插入真实 Word comments,不是纯文本括号批注 使用官方 IELTS band descriptors 评分 可作为 Codex 和 Claude Code 本地 skill 使用
批注锚定学生原文,不批到题目或 outline 上 内置教师风格规则和样本提炼参考 包含 DOCX 提取、生成、验证脚本
在原文后插入简洁的 italic rewrite Task 1 强制先看图,Task 2 强制先看任务回应 保留原文件,输出独立 reviewed copy
输出分数页、短反馈和范文 默认斜体改写 Band 7.5,结尾范文 Band 8.0 可通过 prompt 自定义目标分

批改流程

flowchart LR
    A[学生答案或作文] --> B{IELTS review skill}
    B --> C[Word 真批注]
    B --> D[官方维度评分]
    B --> E[教师风格精修改写]
    B --> F[默认 Band 8.0 范文]
    C --> G[Reviewed Word document]
    D --> G
    E --> G
    F --> G

安装

通用 agent 安装提示词

Install the IELTS Writing Review Skills from this GitHub repository: https://github.com/AaronL725/ielts-writing-review-skills and put the two skills into the correct local skills directory.

也可以手动安装:

先克隆仓库:

git clone https://github.com/AaronL725/ielts-writing-review-skills.git
cd ielts-writing-review-skills

Codex

把两个 skill 安装到 Codex skills 目录:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R skills/ielts-task1-review skills/ielts-task2-review "${CODEX_HOME:-$HOME/.codex}/skills/"

Claude Code

安装为 Claude Code 个人 skills:

mkdir -p "$HOME/.claude/skills"
cp -R skills/ielts-task1-review skills/ielts-task2-review "$HOME/.claude/skills/"

如果想只在某个项目中使用,可以复制到项目级 .claude/skills

mkdir -p .claude/skills
cp -R skills/ielts-task1-review skills/ielts-task2-review .claude/skills/

Prompt 示例

Use $ielts-task1-review to review my IELTS Academic Writing Task 1 answer: [paste the path of your answer]
Use $ielts-task2-review to review my IELTS Writing Task 2 essay: [paste the path of your essay]
Use $ielts-task1-review to review my IELTS Academic Writing Task 1 answer. Target band: [your target band]. File: [paste the path of your answer]
Use $ielts-task2-review to review my IELTS Writing Task 2 essay. Target band: [your target band]. File: [paste the path of your essay]

每个 Skill 包含什么

Task 1 skill 包含视觉分析流程、Task 1 官方评分标准、教师风格批改规则、样本提炼参考、图表样本、DOCX 提取脚本、DOCX 生成脚本和验证脚本。

Task 2 skill 包含题目与作文提取、Task 2 官方评分标准、教师风格批改规则、样本提炼参考、教师样本匹配逻辑、DOCX 生成脚本和验证脚本。

仓库结构

.
|-- assets/
|   `-- ielts-writing-review-skills-hero.png
|-- docs/
|   |-- README.en.md
|   |-- README.es.md
|   |-- README.ja.md
|   `-- README.ko.md
|-- examples/
|   |-- C19T4 Writing Task 1.docx
|   |-- C19T4 Writing Task 1(reviewed).docx
|   |-- C19T4 Writing Task 2.docx
|   `-- C19T4 Writing Task 2(reviewed).docx
|-- skills/
|   |-- ielts-task1-review/
|   |   |-- SKILL.md
|   |   |-- agents/
|   |   |-- references/
|   |   `-- scripts/
|   `-- ielts-task2-review/
|       |-- SKILL.md
|       |-- agents/
|       |-- references/
|       `-- scripts/
|-- LICENSE
`-- README.md

兼容性

Agent 状态 说明
Codex Ready 复制到 $CODEX_HOME/skills,通常是 ~/.codex/skills
Claude Code Ready 复制到 ~/.claude/skills 或项目 .claude/skills
其他本地 agents Manual 使用通用安装提示词,并把两个 skill 放到对应 agent 的本地 skills 目录

⭐️ 给这个仓库点 Star

如果这个仓库能节省你批改 IELTS Writing 的时间,点一个 star 可以帮助更多学习者和老师找到它。