MrGeDiao/shuorenhua

shuorenhua (说人话) – 中文AI风格「人话化」技能

是什么 – 一个可插入LLM驱动代理（Codex、Claude Code、Cursor、ChatGPT等）的轻量级 技能，用于重写中文文本，使其不再听起来像通用AI生成的回复。它移除典型的“AI语气”模式（过度礼貌的开场、工程师用语、营销术语、翻译腔、无来源的权威主张），同时 保留所有事实细节 —— 数字、版本、命令、错误信息、引用和时间戳均保持原位不变。

为何使用

场景	shuorenhua 的作用
非正式聊天	剪除冗余开场和销售式结尾，保持对话自然流畅。
技术状态更新	保留事实、版本号、命令片段和错误日志，同时清除空洞的“进展”语言。
README / 发布说明	展示清晰的变更列表、版本、验证步骤和限制——无促销性赘述。
论坛帖子 / 问题回复	读起来像一位负责的维护者，而非模板化公告。
长篇中文文章	移除空话，以 “建议删除” 形式列出，供人工审核，确保原文长度和关键信息完整保留。

如何工作

1. 场景检测 – 判断输入是聊天、状态、文档还是公开写作，并加载相应的 场景包（README、发布说明、论坛帖等）。
2. 保护段提取 – 自动锁定数字、版本字符串、文件路径、命令行、错误追踪、姓名和责任声明。
3. 强度分级 – 将文本分为 Tier 1/2/3，并选择重写强度（最小 / 标准 / 激进）和作用范围（结构 / 限定 / 就地）。
4. 模式化重写 – 应用精心筛选的中文AI风格模式词典；并非盲目查找替换。
5. 保真度检查 – 重新阅读输出，确保所有保护段和事实关系未被更改。
6. 残留审计 – 第二轮轻量级处理，仅修复残留的“AI味”余渣。

规则集位于 references/（正向风格指南、保护段列表、场景包定义），刻意严格：数字必须与对象绑定，关系不可更改，时间跨度不可缩短，不可虚构新事实。

快速上手（约30秒）

• ChatGPT (Plus/Pro) – 使用托管的 “说人话 GPT” 链接；粘贴文本并要求“把这段去 AI 味”。
• Claude Code – 运行 README 中显示的两个插件命令，然后输入 把这段去 AI 味。
• Codex – 克隆仓库并执行一行命令，如：

  codex exec -C . "读取 ./SKILL.md，按其中规则改写以下文本：…"
  

• 其他代理 – npx skills add MrGeDiao/shuorenhua（或参考平台特定的 install/*.md 文档）。

对于长篇文档，可请求 注释模式（只标注不改写），获取建议删除项列表但不实际删除内容。

评估

• evals/benchmark.md 提供 103个案例（57个“必须改”，46个“必须留”）的公开基准测试。
• 按模型（Codex、Claude）报告结果，包含硬约束失败（L1）、误报率（SNF）和风格目标指标（L2）。最新版本（v2.3.0）在盲测集上实现0次硬约束失败，误报率低于10%。
• 自动化脚本（automation/eval/hard_metrics.py）可计算长文本运行中的长度保持、连字符密度和保护段完整性。

安装

平台	文档
Codex	install/codex.md
Claude Code	install/claude-code.md
Cursor / Windsurf	install/cursor.md
OpenClaw	install/openclaw.md
ChatGPT / 自定义GPT	install/chatgpt.md

技能核心为单一文件 SKILL.md；如需完整功能（场景包、保护段列表），请包含 references/ 目录。

许可证 – MIT。

---

TL;DR – shuorenhua 是面向LLM代理的中文“人话化”技能，剥离AI风格模板的同时保证事实准确性。通过规则驱动的模式匹配、场景感知的强度设置和双轮验证流程实现，附带全面基准测试和主流AI助手平台的简易安装。