MrGeDiao/shuorenhua

说人话是一个中文优先的文字编辑 skill，用来清理套话、重复铺垫和生硬句式。数字、条件、承诺和作者本来的意思要保留；正常文字可以不改。

适合改 README、Release Note、工作同步、issue 回复和个人文章，也支持英文与只标问题。它不判断文章是不是 AI 写的，不提供“AI 含量”或规避检测的保证。

v2.5.1 已发布。 本版是保养更新，改写规则与 v2.5.0 相同，已安装 2.5.0 的不用升级。v2.5.0 重建了编辑规则，Claude Opus 5 完成 136 条、Grok 4.6 完成 56 条定向验收；范围、结果与限制见评测记录。

把原文交给支持加载 skill 的工具，然后说明要求：

把这段去掉套话，保留信息和我的口气：……
只在句内改，不删句、不并句：……
只标问题，不改写：……

默认交完整改写稿，不附判定链和评分。不需要修改时返回原文；来源提示和删除建议放在正文后。

例如，原文是：

本次完成了对重试策略的调整。重试策略已经调整过了。重复请求从 24 次降到 7 次。

可以改成：

本次调整了重试策略，重复请求从 24 次降到 7 次。

但“得到批准后，我可以周五前交一版草案”里的条件、“可以”和交付动作都要留下，不能顺手改成确定承诺。更多对照见示例。

运行规则收为三个文件：入口、编辑边界、示例。两份参考按需读取。旧词表、场景包和固定多步流程退出运行包，完整快照留在历史目录。

编辑按内容判断，不按词语命中次数替换。“闭环控制”、引用中的“赋能”、有意重复和真实对比都可以保留。原文只谈潜力或目标时，也不要求模型补出具体实现。

程序代码块（包括注释和文档字符串）默认逐字保留；只有用户明确点名修改注释或说明文字时才编辑相应部分，且不改程序行为。代码围栏里的普通文案仍可按要求清理。

来源处理有一项明确变化：“研究表明”没有附出处时，默认保留归属与论断，必要时在正文外提示缺来源。用户明确要求删除无源论断或指定 rewrite-safe，才按允许的范围处理；不能只删“研究表明”，把结论变成已核实的事实。

引号按用途判断：作为依据的原话、文献、规范、界面文字、正在定义的词，以及书名号里的标题和名称按原文保留。叙述中的讲话可以清理口头填充和重复，保留说话人的事实、判断和“可能”“我觉得”等情态；用户要求保留口述原貌时不改。

默认改写较保守：清理赘语和句法，保留背景、定位、程度与作者评价。心理、感受和安抚类陈述也先保留；明确要求删去这类内容时再处理。审稿模式可以指出问题，但不会替作者撤回判断。

用户要求优先。中文公开长文约 1000 字以上默认保留句段结构。minimal / standard / aggressive 仍可使用，不放宽保真要求；2.5 里三档还没有分开的规则，实际效果接近。

安装 full 时只复制 runtime-files.json 列出的三个文件，保持相对目录。不要把 evals/ 和 tasks/ 放进 skill 扫描目录。仓库开发文件不会自动更新已安装副本。

已有安装入口见 Codex、Claude Code、Cursor / Windsurf、OpenClaw、ChatGPT。请按对应工具的说明安装；升级前先核对本地定制。

评测先看保真与任务是否完成，再看编辑是否有阅读收益。判据独立于 skill 文案，也不指定某个模型必须当判官。

主集 123 条，其中 65 条待改善文本、58 条正常文本；新增 3 条按引号用途判断的用例。已完成 Claude Opus 5 的 136 条和 Grok 4.6 的 56 条定向验收。信息与任务硬失败均为零，正向样本各有 5/7 条改善、2 条持平。Claude 正常文本误改为 0/58；Grok 只覆盖其中 11 条，未发现误改，不代表完整误改率。20 条场景样本与 10 篇 HUMAN 长文各自记录，不相加。新版使用冻结的中性请求和编辑质量判据，不要求模型删除某个指定句式。

发布要求包括信息与任务硬失败为零、正常文本误改率低于 10%，以及 7 条正向编辑样本至少 5 条有收益。脚本通过只证明结构和证据校验通过，不证明改写质量达标。

还会误改吗？ 会。尤其要核对否定范围、可能与承诺、作者判断和长文中的结构限制。欢迎附脱敏原文、请求与实际输出反馈。

长文为什么改得很少？ 这是已知缺口。在较长的公开文章里，2.5 对黑话和叠用比喻清理得偏少，常常只修了语病和标点。我们试过放宽清理范围，但会出现改动作者判断强度或作者自己术语的情况，还没达到发布标准，所以暂不发布，经过见 #16。2.4.x 清理得多一些，但也可能改变原意，如果使用，请逐处核对修订。如果在 2.5 里明确要求「彻底清理，黑话都换成大白话」，它会多改一些，但会把部分说法换成它猜测的意思而不作标记，也会改动判断强度（比如把「完美融合」改成「配合得很好」），同样请逐处核对。我们测试过一个会原位标出猜测的「彻底清理」模式：改得更多、错得更少，但仍会改动判断强度，暂不发布。

英文能用吗？ 可以。默认保留原文语言，重点仍是中文。不会为了避开某个英文词而改换事实。

能模仿某个人的文风吗？ 本项目主要清理多余表达，保留原有口气。它没有针对特定作者做风格训练。

请用 Bad Case 模板 提供具体原文、编辑要求和输出；避免提交未授权聊天、密钥或个人隐私。新问题优先补可复现案例，是否需要加规则再看证据，见贡献说明。

shuorenhua is a Chinese-first editing skill. It removes unnecessary wording while preserving facts, conditions, modality, attribution, and the writer’s voice. It also supports English and review-only requests. Version 2.5.1 is a maintenance release that keeps the editing rules rebuilt in 2.5.0; validation coverage and limitations are recorded separately. It is not an AI authorship detector.

• stop-slop — 英文冗余表达规则
• humanizer — 英文写作模式整理
• avoid-ai-writing — AI 写作问题分类
• speak-human-tw — 繁体中文编辑规则

MIT