convez.ai
SkillAutomaçãoAvançado
tyxo0o315

IELTS Writing Review

tyxo0o315/ielts-writing-review

Corretor inteligente + gerador de simulados IELTS via Notion

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-review

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 帮你串起一条完整流水线:

  1. 写作模式 — 从 Notion 题库一键生成本地 HTML 模拟器,带计时器 / 字数统计 / 提交后批改 prompt
  2. 批改模式 — 写完后让 Claude 按官方 4 维度评分,找语法错误、升级表达、给改进版作文
  3. 彩色写回 — 批改结果按颜色规范写回 Notion 对应题目页(红色=语法错、蓝色=升级表达、绿底=改进版……)

一次配置完,以后做剑桥真题就一行命令的事。

🎬 它能做什么

Review 模式

你: /ielts-review
你: 帮我批改一下 15-1
你: 这是我的作文:…

Claude 会:

  1. 去 Notion 找 "15-1" 页面,读取题目和图表
  2. 先把图表图片下载下来看一眼(避免漏题点,详见 陷阱区)
  3. 按 Task Achievement / Coherence / Lexical / Grammar 四维度评分
  4. 列语法错误(红色 + 划线 + 绿色正确版)
  5. 列表达升级(灰色原文 + 蓝色升级版)
  6. 给完整改进版作文(绿底斜体)
  7. 把以上所有内容用 Notion 原生彩色 block 写回 15-1 页面

Generate 模式

你: /ielts-html
你: 把剑桥 16 生成一个本地模拟页面

Claude 会:

  1. 去 Notion 找 "16" 父页面下的 "16-1" 和 "16-2"
  2. 抽出 Task 1 题目 + 图表(base64 嵌入)
  3. 抽出 Task 2 题目
  4. 套用 HTML 模板,生成 ~/Desktop/IELTS-16.html
  5. 双击打开就是一个完整的考试模拟器

模拟器特性:

  • 双 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 只处理你自己整理的题目,不分发任何真题文本
Ver o original no GitHub

Bom para

Relacionados