Gyanesh5/plain-zh

plain-zh 平实中文

写给人读的中文：术语先定义再使用，一个概念只用一个名字，比喻不进标题，结构平实。

每条规则尾注证据等级：

• 〔实测〕来自 lieflat-less-ai-tone 的 270 对同题同事实配对语料，两轮同向
• 〔认知〕认知科学依据（Pinker 知识诅咒、Cowan 工作记忆容量）
• 〔工程〕成熟工程实践（ASD-STE100 受控写作、中文文案排版指北）
• 〔约定〕本项目设计约定，无实验证据，可按需调整

两种模式

生成模式（写作前加载）：动笔前确定受众与术语表，写完按 P1-P7 自检。POLICY.md 是本模式的 8 行精简版，适合嵌入 AGENTS.md / CLAUDE.md / SOUL.md 常驻。

审阅模式（对成稿操作）：按「审阅模式工作流」出报告、等确认、再改写。

项目术语表机制

生成与审阅都先查项目术语源，再动笔：

1. 术语源优先级：用户当次指令 > 项目术语表（CONTEXT.md、GLOSSARY.md、术语对照表）> 本规范默认值。项目词条怎么定的就怎么用，不按本规范重写既有术语
2. 与第三方工作流共存：项目跑 mattpocock 类技能（wayfinder、to-spec 等）时，其 CONTEXT.md 词条、命令与隐喻词（wayfinder=任务地图、grill=追问裁决、to-tickets=拆实施票、到站=目标达成、进雾=暂缓待定）一并作为项目约定消费；接口词按 P3 双轨处理
3. 增量治理：存量文档不重写，决策档案的证据链优先；项目无术语表且一次审阅命中 3 个以上未对照术语时，报告末尾建议补一张术语对照表，之后的新文档从对照表走

R1 术语纪律

P1 先用后词〔认知〕

任何术语、缩写、文件名、字段名、工具名，首次出现前必须先定义或给出中英对照，禁止凭空出现。判断方法：读者此前是否见过这个词？没见过，先花一句话交代它是什么。

• 改前：「跑一下 build_assets.py 就行」
• 改后：「先用仓库自带的资源打包脚本 build_assets.py 打包，再运行」（同位语直接写，不加括号；确需括号时见 P18）

保留：本篇上文已定义过的词；目标读者的常识词。

P2 同一概念同一术语〔实测〕

一个概念从头到尾用一个名字。不轮换同义词，不中途发明新说法。

证据：同义重命名 AI 0.83-0.86 次/段，人类 0.49；一段内出现 2 次以上的段落，AI 占 20.6-22.5%，人类 8.4%。

• 改前：同一段里「优化／增强／提升」轮着说同一件事
• 改后：全文统一用「优化」

保留：文学性指称变化；正式引入术语时的「又名 X」。

P3 术语首现对照，不自造译名〔工程〕

有通行译名的用通行译名；没有的，首次出现写「中文（English）」，后文用中文。禁止自造黑话式译名和统计黑话。

• 改前：「模板 chrome 五件套」「众数回归」「离众数」
• 改后：「模板化界面元素（chrome）：眉题、元信息串、破折标签」「回归均值」

保留：行业固定英文（API、CI/CD）；团队约定保留原文的词（视项目术语表）。

接口词双轨：斜杠命令、标签（Label、Status、Type）、配置键是 agent 的调用接口，保留原文不翻译；但进入人类正文时首现给对照。

• 改前：「05 号票 grill 时首先与用户确认」
• 改后：「05 号票 grill（追问裁决）时首先与用户确认」

机器元数据行（Label、Status、Blocked by 等）集中放在文件头部元数据区，不散落正文；段落标题用中文，或中英双语并列，不整段保留英文标题。

P4 比喻限额〔约定〕

每个概念最多一个比喻，比喻只出现在解释处，不进标题、不当术语反复使用。模型判不了比喻贴切度（模型间共识 0-40%），事后筛选不可靠，所以从源头限量。

• 改前：标题「1. 出身与它要解决的问题」；「三根柱子／柱子一／柱子二」当章节框架
• 改后：标题「1. 来源：它解决什么问题」；「三个原则／原则一」

保留：用户明确要求的风格；教学场景里确认有效的比喻（每概念限一个）。

R2 读者校准

P5 受众与已知清单〔认知〕

动笔先定两件事：写给谁、默认知道什么。行文只引用读者已建立的概念。知识诅咒（curse of knowledge）：作者知道的，读者未必知道，而作者最容易忽略这个差距。

P6 未定义缩写限额〔认知〕

每 100 字最多 1 个未展开缩写。工作记忆一次约挂 4 个未知项，连续缩写会迫使读者「停车存疑」，超过限额先展开或删减。

P7 跨域概念给类比〔认知〕

引入读者领域外的概念时，给一个读者域内的类比，并说明类比的失效边界。类比负责入门，边界负责不失真。

• 示例：「寄存器像停车位：每个位只放一个值。但寄存器没有『停满』一说，写入即覆盖。」

R3 结构信号

按证据强度排序。命中不是罪名，是提示；每处回到上下文判断是否成立。

P8 翻案腔〔实测 3.4 倍〕

「不是 X，而是 Y」「你以为…其实…」「看似…实则…」「与其说…不如说…」。多数情况直接下判断。

• 改前：「模型不是在抄，它是在回归均值」
• 改后：「模型没有在抄袭谁，它输出的是统计上最常见的写法」

保留：纠正真实误解（「错误发生在保存阶段，而不是上传阶段」）。

P9 提示语冒号〔实测 3.8 倍〕

「一句话总结：」「核心是：」「关键在于：」「原因如下：」。提示语不承担信息就删掉，直接写结论；前半句确实承接上文时，只把冒号换成句号。

P10 衔接连环〔实测：AI 中位 7 连环，人类 2〕

段段开头接住上一段末句关键词，全文零跳转。在连环中留 1-2 处自然跳跃，让读者参与推理。

保留：教程、法律文书等要求紧扣的文体。

P11 同构三连〔实测：AI 29.4%，人类 10.7%〕

连续三句共用同一句法骨架（同样的开头结构、同样的收尾节奏）。拆掉其中一句：合并、拆分或换语序，不是删内容。

保留：刻意修辞（演讲、檄文）；清单体；叙事推进的三件事。

P12 翻译腔四结构〔实测〕

只处理四种：过长前置定语（中心词前修饰超过 15 字，或连续两个「的」）；「当…时」前置从句；「对于…来说」「就…而言」话题壳；相邻段落句首连续用「然而，／因此，／此外，」当路标。能拆就拆，确实承担时间或逻辑功能的保留。

P13 枚举与压缩密度〔实测：顿号罗列 AI 3.21 vs 人类 1.78 次/千字，配对复测密集并列 AI 1.45 倍，两轮同向〕

一个分句的并列项不超过 3 项；超过时展开为列表，或概括后给出处链接。禁用计数集合词——「监控四件」「对比六件套」「diff 三件套」要么逐项写明，要么首现展开定义后再用缩写。斜杠枚举同判。

• 改前：「M7 包含页重做/参数重要性/烂轮早停/监控四件/Retry/表单」
• 改后：「M7 包含六项：Agent 页重做、参数重要性分析、烂轮早停、四项监控（GPU 曲线、时长预估、桌面通知、loss 双线）、一键 Retry、表单改造」

保留：命令行参数、错误码表、清单体文档的本职罗列；顿号三项并列属正常写法（X 级教训：句内排比人类用得不少），只有四项以上且结构同构时才处理。

P14 词表降权〔实测：差异不显著〕

「赋能、抓手、闭环、深耕、沉淀」等词表命中只作低权重提示，不单独作为修改理由。结构信号（P8-P12）优先于词表。

X 级（永不改）：以下特征经配对复测无区分力或方向相反，检测到也不改——序数词小标题、「这意味着」式复述、空转句引列表、「首先／其次／总之」、设问句、句长均匀化改造、精确数字堆砌。

R4 文体边界

P15 拟剧框架需显式要求〔约定〕

课堂人格（「教具已发」「开讲」「标本馆」）、剧场旁白、访谈框架、悬念式预告（「停一下——」），只在用户明确要求时启用。默认平铺直叙。

P16 金句限额〔约定〕

格言式总结每篇最多 1 处。禁用「一句话带走」式收尾预告。

P17 中英混排〔工程〕

中英文之间加空格；中文语境用全角标点；数字与单位之间加空格。细节遵循中文文案排版指北（sparanoid/chinese-copywriting-guidelines）。

P18 标点与括号〔工程：GB/T 15834—2011、CY/T 154—2017〕

注释写法按优先级：同位语直接写 > 括号 > 破折号。能写成同位语的注释不用括号；括号放「可不与正文连读」的旁注；破折号注释属于正文、需要连读，中文技术文少用（高密度破折号同时是实测的 AI 写作指纹）。

• 同位语（首选）：先用仓库自带的资源打包脚本 build_assets.py 打包，再运行
• 括号（旁注）：支持批量导出（需要管理员权限）
• 破折号（连读注释，少用）：确需时用两字线——，占两字位置不断开，前面通常不加标点

括号全半角按内容与邻接环境判定，全篇体例统一（CY/T 154 的一致原则）：

场景	形式	示例
成对翻译「中文（English）」	全角，前后不加空格	消息队列（Message Queue）
含中文的注释	全角，前后不加空格	支持批量导出（需要管理员权限）
纯英文、数字、版本号引用	半角，括号前留空格	基于 Spring Boot (v3.2.0) 开发
括号紧邻代码或文件名	半角，两侧留空格	运行 build.sh (首次运行会下载依赖) 后重启

已知分歧：出版惯例对「中文（English）」用全角（GB/T 15834、指北示例）；部分工程规范对纯英文内容一律半角加空格（Gengo）。plain-zh 默认全角对照、半角工程引用；项目有自己的约定时从约定，全篇不切换。

其余硬规则：

• 括号不套用；必须嵌套时内外用不同形式（外〔〕内（））
• 句内括号紧跟被注释词，末尾不加句号；句外括号放在句末点号之后
• 引号：简体默认""、嵌套''；直角引号「」『』用于繁体或项目约定用「」的场景，全篇统一
• 省略号用……，不用三个句点
• 中文句里的英文并列项仍用顿号（如：at the bus stop、at the railway station）
• 括号注释每段不超过 2 处，连续旁注改为正文展开

保留：代码块与命令行内的半角括号；数学公式括号；表格内的紧凑括号；项目既有排版约定。

R5 改写纪律（审阅模式适用）

P19 最小改动

一处命中只改解决该问题所必需的部分，不顺便润色，不动相邻文字。改得越多，引入新错误的机会越多。没有把握时保持原文。

P20 信息守恒

事实、数字、限定词、归因、否定范围完整保留。「可能」不改成「确定」，「计划」不改成「已完成」。改写新增的每个实词都要能在原文指出出处。

P21 结构不动

标题层级、章节顺序、段落顺序、列表表格引用代码块的位置原样保留。改标题前检查全文引用和锚点。

P22 改后自查

逐项过：新增实词有出处？术语全部首现定义（P1-P3）？接口词已对照（P3）？标题无比喻（P4）？未定义缩写达标（P6）？翻案腔与提示语冒号已处理或注明保留理由（P8-P9）？枚举与压缩密度达标、无计数集合词（P13）？标点与括号合规、注释优先同位语（P18）？拟剧框架未启用或为用户所要求（P15）？

三层判断分工

• 可数指标（缩写计数、比喻密度、同词轮换、破折号密度）：可脚本化，本项目预留 detect 接口
• 句意判断（命中是否成立、保留边界是否适用）：模型按本文件封闭判据逐条判，拿不准标「待核」
• 比喻贴切度：只列出候选，由用户判断，模型不评

审阅模式工作流

1. 通读全文，判断文体与受众，列出需要保留的主张、数据与限定
2. 按 P1-P18 逐条检。每处命中记录：规则号、原句位置、改法、判定（拟改／保留／误报／待核）。保留必须给具体理由，不能只说「读着自然」
3. 出报告：按 R1-R4 分组列命中（原句、改法、判定），统计分口径（术语类／结构类／文体类）。只请用户对整套建议回复「按建议改」或提出调整，不逐条索要决定
4. 收到确认后改写，遵守 P19-P21。每处改动记录「原文、改后、命中规则号」
5. 改后按 P22 自查，输出前后对照（改动处用删除线与插入标记），复核拟改项是否清零

交付前核对

• 每个术语首现有定义或对照（P1、P3）
• 同一概念一个名字（P2）
• 标题无比喻（P4）
• 未定义缩写不超过限额（P6）
• 翻案腔、提示语冒号已处理或注明保留理由（P8、P9）
• 拟剧框架未启用，或为用户明确要求（P15）
• 并列枚举不超过限额、无计数集合词（P13）
• 事实、限定词、结构未动（P19-P21）
• X 级特征没有被误改

来源

• lieflat-less-ai-tone：R3 全部判据与 X 级清单（629 篇对照 + 270 对配对复测）
• Fenng/Tech-Doc-Style-Chinese：ASD-STE100 受控写作思路（P2、P3）
• francoisdp/skills（anti-ai-writing）：双模式架构与 Rule 25 先用后词（P1）
• op7418/Humanizer-zh：保留边界三段式与信息守恒（R5）
• sparanoid/chinese-copywriting-guidelines：混排规范（P17）
• GB/T 15834—2011《标点符号用法》、CY/T 154—2017《中文出版物夹用英文的编辑规范》：标点形式与体例统一原则（P18）
• Gengo 中文风格指南：括号全半角按内容判定的工程规则（P18）
• cloudflare-docs eli5 skill：类比与失效边界（P7）
• opencue/cuecards ai-slop-detector：未定义缩写的认知负荷依据（P6）

许可

MIT