Easy Read — AI skill for Claude Code

Easy Read | 人话翻译器

把看不懂的东西，变成谁都能看懂的大白话词汇表。

[English](#english) | [中文](#中文)

---

中文

这是什么

你有没有过这种体验：

• 刷到一篇 AI 新闻，标题写着"基于 RAG 的 Agentic Workflow 实现了 Context Engineering 的范式跃迁"
• 拿到体检报告，上面写着"TSH 偏高，建议排查甲状腺功能亢进"
• 签合同前想看看条款，满眼"不可抗力""连带责任""仲裁管辖"
• 想学理财，基金说明书里全是"PE""ROE""夏普比率"

**每个字你都认识，连起来就是天书。**

Easy Read 就干一件事：**把这些话翻译成人话。**

🤖 翻译前：「基于 RAG 的 Agentic Workflow...」 ✅ 翻译后：「让 AI 回答问题前先查资料（像考试允许翻书），然后自己规划步骤完成任务。」

🏥 翻译前：「TSH 偏高，建议排查甲状腺功能亢进」 ✅ 翻译后：「甲状腺激素的指挥官（TSH）数值偏高，可能是甲状腺太亢奋了，在加班加点分泌激素。需要进一步检查确认。」

⚖️ 翻译前：「因不可抗力导致的违约不承担连带责任」 ✅ 翻译后：「如果是地震、洪水、战争这种谁都控制不了的事导致没法履行合同，不用赔钱，也不用替别人背锅。」

它会把文章里所有你看不懂的术语，自动整理成一份**带发音、带解释、带来龙去脉的词汇表**，生成好看的 HTML 页面。打开就能看，存下来还能转发给爸妈。

支持的领域

	领域	典型场景
🤖	AI / 科技	科技新闻、产品发布、技术博客
🏥	医学 / 健康	体检报告、药品说明书、医学新闻
⚖️	法律	合同条款、判决书、法律新闻
💰	金融 / 财经	财报、基金说明书、经济分析
📚	学术论文	跨学科论文、研究报告
📋	政策文件	政府白皮书、红头文件、政策解读
🎮	游戏	更新日志、游戏机制、攻略
🔗	区块链 / Web3	白皮书、DeFi 术语
🔧	硬件 / 数码	手机评测、电脑配置、参数对比
📖	任何领域	只要你看不懂，就能翻译

主要功能

• 零门槛：完全不懂这个领域也能用，给家人看专业内容就靠它
• 自动识别领域：扔进去的内容是什么领域，它自己判断
• 自动抓术语：专业概念、缩写、行话，一个不漏
• 输出好看：HTML 词汇表，带难度等级、发音指南、来龙去脉
• 格式随便扔：文本、文件、网址、PDF、截图都行
• 全 Agent 通用：Claude Code、Codex、Cursor、Cline 都能跑

安装

Claude Code（推荐）

将 skill 文件复制到你的 Claude Code skills 目录：

# 克隆仓库
git clone https://github.com/HeiGeAi/easy-read.git ~/.claude/skills/easy-read

或手动复制：

# 创建 skill 目录
mkdir -p ~/.claude/skills/easy-read/{scripts,assets}

# 复制所有文件
cp SKILL.md ~/.claude/skills/easy-read/
cp scripts/generate_glossary.py ~/.claude/skills/easy-read/scripts/
cp assets/glossary_template.html ~/.claude/skills/easy-read/assets/

然后在 Claude Code 中输入 `/easy-read` 使用。

其他 Agent

Easy Read 的核心是 SKILL.md（指令）+ Python 脚本（生成 HTML），不绑定特定 Agent。只要你的 Agent 能读文件、跑 Python，就能用。

Codex (OpenAI)

git clone https://github.com/HeiGeAi/easy-read.git
# 把 SKILL.md 内容贴进项目的 A