IELTS Writing Review
tyxo0o315/ielts-writing-review
Corretor inteligente + gerador de simulados IELTS via Notion
Ver no GitHubSkill para Claude Code que avalia redações IELTS (Writing Task 1/2) com rubrica oficial de 4 dimensões e gera simuladores HTML locais a partir de base de dados em Notion. Automatiza fluxo completo de preparação: desde a prática com timer até feedback colorido escrito de volta no Notion.
Instalação
npx convez-ai tyxo0o315/ielts-writing-review1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Corrigir redações de Task 1 e Task 2 com rubrica oficial
- Gerar simuladores HTML interativos com timer e contador de palavras
- Sincronizar feedback colorido de volta para base de dados Notion
- Manter histórico estruturado de prática para Cambridge tests
Veredito

Skill sólida e bem documentada para quem prepara IELTS e usa Notion. A integração com MCP server do Notion é robusta, o sistema de cores é inteligente, e a geração de HTML self-contained poupa setup. Recomendado para quem já tem disciplina com Cambridge tests e quer automação real no workflow.
README
A tradução para o português deste README ainda está na fila.
IELTS Writing Review
EN — TL;DR A Claude Code skill that grades IELTS Writing Task 1 / Task 2 essays with the 4-dimension official rubric and writes color-coded feedback back to Notion. Also generates a self-contained HTML test simulator (timer + word count + Claude grading prompts) from your Cambridge test bank stored in Notion.
雅思 (IELTS) Writing 备考工作流的 Claude Code skill —— 一边批改作文,一边从 Notion 题库生成本地模拟考试 HTML 页面。
✨ 这是干嘛的?
如果你像我一样在备考雅思,并且把剑桥真题题目整理在 Notion 里,这个 skill 帮你串起一条完整流水线:
- 写作模式 — 从 Notion 题库一键生成本地 HTML 模拟器,带计时器 / 字数统计 / 提交后批改 prompt
- 批改模式 — 写完后让 Claude 按官方 4 维度评分,找语法错误、升级表达、给改进版作文
- 彩色写回 — 批改结果按颜色规范写回 Notion 对应题目页(红色=语法错、蓝色=升级表达、绿底=改进版……)
一次配置完,以后做剑桥真题就一行命令的事。
🎬 它能做什么
Review 模式
你: /ielts-review
你: 帮我批改一下 15-1
你: 这是我的作文:…
Claude 会:
- 去 Notion 找 "15-1" 页面,读取题目和图表
- 先把图表图片下载下来看一眼(避免漏题点,详见 陷阱区)
- 按 Task Achievement / Coherence / Lexical / Grammar 四维度评分
- 列语法错误(红色 + 划线 + 绿色正确版)
- 列表达升级(灰色原文 + 蓝色升级版)
- 给完整改进版作文(绿底斜体)
- 把以上所有内容用 Notion 原生彩色 block 写回 15-1 页面
Generate 模式
你: /ielts-html
你: 把剑桥 16 生成一个本地模拟页面
Claude 会:
- 去 Notion 找 "16" 父页面下的 "16-1" 和 "16-2"
- 抽出 Task 1 题目 + 图表(base64 嵌入)
- 抽出 Task 2 题目
- 套用 HTML 模板,生成
~/Desktop/IELTS-16.html - 双击打开就是一个完整的考试模拟器
模拟器特性:
- 双 Task 切换 (Task 1 / Task 2)
- 计时器(20 min / 40 min,带暂停、超时红色 pulse)
- 字数实时统计(不足 / 达标 / 良好 三档颜色)
- 提交后弹批改菜单:复制 grade / improve / both 三种 prompt 到剪贴板
📦 安装
前置要求
- Claude Code CLI 已安装
- Notion MCP server 已连接(在 Claude Code 中运行
/mcp配置) - macOS(其他系统理论上也能跑,但 HTML 默认输出路径是
~/Desktop/)
安装步骤
# 1. clone 仓库
git clone https://github.com/tyxo0o315/ielts-writing-review.git
# 2. 把 SKILL.md 复制到 Claude Code 的 skills 目录
mkdir -p ~/.claude/skills/ielts-writing-review
cp ielts-writing-review/SKILL.md ~/.claude/skills/ielts-writing-review/
# 3. 重启 Claude Code,验证 skill 已加载
# 在新会话里输入 /ielts-review 应该能识别
🗂️ Notion 题库结构
你的 Notion 工作区需要按这个层级组织:
IELETS ← workspace 顶级页面(注:原作就这么拼的)
└── 15 ← 剑桥真题册号
├── 15-1 ← Task 1 页面
│ └── column_list
│ └── column (左)
│ └── callout 💡 ← 含「20 minutes, 150 words」
│ ├── paragraph ← 题目文字
│ └── image ← 图表
└── 15-2 ← Task 2 页面
└── callout 💡 ← 含「40 minutes, 250 words」
└── paragraph ← 题目文字(无图)
💡 如果你已有自己的题库结构但跟这个不一样,改 SKILL.md 里
Notion 题库结构一节,Claude 会根据 skill 文档来定位。
🎨 彩色批改色板
写回 Notion 时的颜色规范(也可以在 SKILL.md 里找到完整表格):
| 内容 | 颜色 |
|---|---|
| ⚠️ 重要澄清 | 黄底 callout |
| 📊 评分维度 | 关键分数 orange / 低分 red |
| 📝 原作文 | 灰底段落 |
| ❌ 语法错误 | 划线 red 错误 + 加粗 green 正确 |
| ✨ 表达升级 | gray 原文 + 加粗 blue 升级版 |
| ✅ 改进版作文 | 绿底斜体段落 |
| 🎯 提升潜力 | 绿底 callout |
📋 评分模板
skill 内置标准模板,Claude 会按这个套:
## 📊 Part 1 — 评分
- Task Achievement (任务完成): {分数} — {理由}
- Coherence & Cohesion (连贯衔接): {分数} — {理由}
- Lexical Resource (词汇资源): {分数} — {理由}
- Grammatical Range & Accuracy (语法准确): {分数} — {理由}
🎯 整体预估分:Band {总分}
## 📝 原作文
...
## ❌ 语法 & 拼写错误
...
## ✨ 表达 & 词汇升级
...
## ✅ 改进版作文
...
🚧 踩过的坑(陷阱区)
skill 内置了一个"教训累积区",避免我犯过的错你也犯:
1. 没读图就给 Task 1 评分 ❌
剑桥 15 Test 1 题面写 "people's coffee and tea buying habits",但实际图表只有 coffee 三类(fresh / instant / café),tea 只是顺带在第三个图例里提了一下 "Went to a café for coffee or tea"。
我第一次批改时没看图,凭题面文字给学生扣了 "TA 没写 tea" 的分 —— 是错的。
⇒ skill 里把 "评 Task 1 前必须 Read 图片" 设为强制步骤。
2. Notion MCP 工具 schema 撒谎 😤
mcp__notion__* 工具的 JSONSchema 看起来只支持 paragraph 和 bulleted_list_item,rich_text 也没有 annotations 字段。
别信。 Notion 服务端其实接受所有 block 类型(heading_2/3、callout、divider…)和完整 annotations(bold、italic、strikethrough、color)。直接发就行。
3. API-update-a-block 工具坏了 💥
工具 schema 把 callout/paragraph 包在 type 参数下,但服务端要求顶层字段,怎么传都 400。
绕过方案:API-delete-a-block 删掉 → API-patch-block-children 用 after 参数在原位置插入新版。
4. HTML 模板 150KB+ 一次读会爆 token ⚡
模板内嵌 base64 图表,整个文件超大。用 awk 'NR>=X && NR<=Y' 按行号片段读,别一次性 Read。
🤝 贡献
这个 skill 是给自己用的,但如果你也在备考雅思想用它,欢迎:
- 提 issue 反馈你 Notion 题库的不同结构
- 提 PR 加更多陷阱教训(cumulative learning is real)
- 改进彩色色板(毕竟这是审美问题)
📄 License
MIT — 拿去用,改改也行,但出问题别赖我。
🙏 致谢
- Claude Code — Anthropic 出品的 CLI
- 剑桥雅思真题 — 内容版权归 Cambridge ESOL,本 skill 只处理你自己整理的题目,不分发任何真题文本