Oct 28, 2026

用 yomiyasu 把 AI 生成的日语改写成好读的文章

yomiyasu 是一个 3k 星标 MIT agent skill，专门改写 AI 生成的日语——修正不自然的比喻、主述不清和过度装饰，同时保住数字、否定与断言强度——并且自 2.0.0 起会在返回前对最终稿运行内置的 lint 与 diff 检查。

#tutorial#productivity

AI 生成的日语有一股可以辨认的味道：工具和概念被挂上「壊れる（坏掉）」这类比喻性动词，主语缺失，满屏加粗，该写正文的地方全是列表。yomiyasu 是 ALGO ARTIS 的 Aiichiro Oga 出品的 3k 星标 MIT agent skill，专为修正这些问题而建，本来就自然可读的部分则原样保留。

为什么这个 Skill 重要

按 README 的说法，yomiyasu（よみやす，意为「好读」）改写 AI 生成的日语文章，让它更容易读。它修正不自然的比喻、主述不清、被写成有感情或意志的工具与概念、套话，以及重加粗、列表、emoji、句尾冒号这类装饰。本来就自然可读的部分原样保留。它只处理日语，其指令、检查输出和报告均为日语。

含义是硬约束：数字、否定、条件、谁对谁做了什么、断言的强弱都必须保留。它不会添加原文或你提供的材料之外的事实；当含义无法从文本确定时，它会保留原文措辞并询问写作者，而不是猜。日语 README 记录了七条转换原则——从检查主谓搭配与条件对应，到保持平均句长在 30 到 45 字之间、每句逗号 0 到 2 个。它面向实用写作设计——技术文章、设计文档与规格说明、PR 说明、内部报告——并识别十三种文档类型，包括邮件、会议纪要、幻灯片、论文、随笔、小说和剧本，不改动各类型惯用的文体。

安装

# skills CLI (recommended)
npx skills add nanaism/yomiyasu

# GitHub CLI
gh skill install nanaism/yomiyasu yomiyasu

# openskills (through AGENTS.md)
npx openskills install nanaism/yomiyasu
npx openskills sync

作为 Claude Code 插件安装时，在 Claude Code 里运行下面两条命令；README 注明装好后 skill 名为 yomiyasu:yomiyasu，并提到有用户报告直接写 yomiyasu 会得到 "Unknown skill"：

/plugin marketplace add nanaism/yomiyasu
/plugin install yomiyasu@yomiyasu

在 Claude.ai（网页版），从最新 release 原样上传 yomiyasu.zip，不要解压——GitHub 的 "Download ZIP" 按钮打出的包是整个仓库，可能被拒收。在 Codex 下，把 skills/yomiyasu/ 目录复制到 .agents/skills/yomiyasu/。对于无法加载完整 skill 的宿主环境，README 还发布了两个更小的变体：yomiyasu-mini 把 SKILL.md 控制在 18,000 字符以内，面向有体积上限的宿主，例如 Microsoft 365 Copilot 声明式 agent；yomiyasu-pocket 是一段 400 到 500 字符的指令，不带内置检查。

实战：润色一篇技术草稿

在请求中点名 yomiyasu 并贴上草稿。README 的示例请求：

この文章を yomiyasu で読みやすくして。
（ここに修正したい文章を貼り付け）

可以在请求中说明文档类型、读者的了解程度、谁写给谁——README 以「取引先に送るメールです」（发给客户的邮件）为例。给了关系之后，yomiyasu 会按这个关系下一般人写作时的敬语程度来调整；什么都不说时，它能推断就推断类型，且不改动敬语。
只发送 /yomiyasu 会让它改写 AI 在上一条回答里写的文字，或工作目录正下方的单个草稿（.md 或 .txt）。处理文件时不覆盖原文件，最终稿以新名字保存在同一目录下。
改写文本之后，它会报告改了什么、跑过哪些检查的记录，并在有话可说时给出有意保留的 AI 味措辞和写给作者的问题。要它说「本文だけ」（只要正文）就能单独拿回改写后的文本；检查照常运行。

自 2.0.2 起，agent 只在你明确要求时才使用 yomiyasu——请求里点名、发送 /yomiyasu，或明确要求日语校对 skill。想让它对每次日语改写都生效，日语 README 记录了要粘贴到你的 CLAUDE.md 或 AGENTS.md 的那一行。

内置检查

自 2.0.0 起，yomiyasu 在返回最终稿之前会先运行内置检查：被改动的数字、否定或主宾对调会以待复核条目的形式浮现出来。这个 skill 附带四个只需标准库的 Python 脚本，在 Python 3.9 和 3.14 上测试过：

python3 scripts/yomiyasu_lint.py article.md
python3 scripts/yomiyasu_lint.py article.md --fail-on warn   # exit code 1 if there are warn or error items
python3 scripts/yomiyasu_diff.py original.md rewritten.md
python3 scripts/yomiyasu_check.py run --source original.md --final final.md
python3 scripts/yomiyasu_check.py verify --final final.md

yomiyasu_lint.py 逐行列出值得复核的表达与 Markdown 格式；yomiyasu_diff.py 把可能改变含义的修改排在最前；yomiyasu_check.py 运行 lint 加 diff，并把记录保存在仓库顶层的 .yomiyasu/；yomiyasu_hook.py 是面向 Claude Code 和 Codex 的可选 hook，只有你把它加进自己的设置才会运行。这些脚本只报告待复核条目和改动位置——不判断含义是否保留。.yomiyasu-words/（allow.txt、flag.txt）里的项目词表可以去掉误报并加入项目专属词汇。

技巧

不要编辑已安装 skill 目录里的文件：README 警告某些安装方式在更新时会整体替换目录，你的修改不会保留。项目词汇放进 .yomiyasu-words/，你自己的指令放进 CLAUDE.md 或 AGENTS.md。
lint 的 --json 分数键是 rule_penalty_score（1.1.2 及之前是 score）——README 指向 docs/tools.md，那里有用 jq 读取旧 JSON 的示例。
改写功能是在 macOS 上通过 Claude Code 和 Codex 的非交互命令（claude -p 与 codex exec）检查过的；按 README 的限制部分，交互式界面、插件或 CLI 安装路径、Codex Cloud、Cursor、Claude.ai ZIP 上传、Windows 上的改写均未测试。

何时不用这个 Skill

它只处理日语——对任何其他语言来说它就不是这个工具。README 也明确说检查只能抓住固定模式：没有任何 lint 条目的页面仍需要对照原文通读。它是 Aiichiro Oga 的个人项目，按 README 的说法并非 ALGO ARTIS 的官方产品，也不代表公司观点。

查看排行榜了解更多 skill。