Community寫作與編輯github.com

Gyanesh5/plain-zh

平实中文输出规范。两种用法:写作时塑形(事前预防)、成稿后审阅改写(事后清理)。覆盖术语纪律、读者校准、结构信号、文体边界四层,规则按证据强度分级标注。适用于中文技术写作、教学讲解、AI 助手回复的生成与审阅。

plain-zh 是什麼?

plain-zh 是一套专为中文技术写作与 AI 助手输出设计的平实中文规范,旨在解决中文写作中常见的术语混乱、结构模糊、翻译腔等问题。它通过两条核心路线发挥作用:写作前加载规范进行塑形(事前预防),以及对成稿进行审阅改写(事后清理)。规范分为四个层次:术语纪律(R1)强调术语首现定义、同一概念统一用名、禁止自造译名;读者校准(R2)要求明确受众与已知清单、控制未定义缩写;结构信号(R3)消除翻案腔与提示语冒号等AI写作指纹;文体边界(R4)约束比喻与金句的使用。每条规则均附有证据等级标注,如来自大规模配对语料实测或认知科学依据。本技能支持主流AI代理平台(如Claude Code、Cursor、Codex),并可作为 AGENTS.md / CLAUDE.md 等常驻配置。工作流采用审阅模式,用户确认后方可改写,确保最小改动与信息守恒。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Gyanesh5/plain-zh/tree/HEAD

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 级特征没有被误改

来源

许可

MIT

相關技能