changwenc / plain-chinese

简明中文（plain-chinese）

这个 skill 规定「怎么写」：用一套显式规则写中文，让读者读一遍就懂。

背景：英文有 ASD-STE100（简化技术英语）。在提示里写一句「in ASD-STE100」，模型就会调出整套写法。中文没有这样一个名字。所以本 skill 把规则写成清单。

核心原则只有一条：简单指语言简单，不指内容变少。 改写后可以比原文长。

什么时候用

• 写中文的技术解释、概念说明、操作步骤。
• 写学习笔记、复习材料、报告、总结。
• 解释 AI 或 agent 的产出：它做了什么、为什么、结果在哪。
• 用户要求改写一段难懂的中文。

不用于：小说、文案、演讲稿、需要个人语气的文字。这些文字靠语气，本 skill 会把语气写平。

规则

词

1. 一个术语只有一个意思。 术语第一次出现时给一句定义。之后一直用同一个词，不换同义词。

   • 不这样写：先叫「缓存」，后面又叫「快取」「暂存区」。

2. 用具体的词，不用比喻和黑话。 写出真正的动作和对象。

   • 不这样写：「把这个坑兜住」。这样写：「在输入为空时返回默认值」。

3. 动词直接用。 不写「进行」「加以」「做出」加动词。

   • 不这样写：「对数据进行清洗」。这样写：「清洗数据」。
4. 数字带单位，范围写清端点。 写「大于 10」「不小于 10」，不写「10 以上」。不写「大概」「一些」「若干」，除非原文本来就不确定。

句

1. 一句只讲一件事。 描述句尽量不超过 25 个字。超过时拆成两句。

2. 写清谁做什么。 用主动句，主语明确。

   • 不这样写：「数据被处理后返回」。这样写：「服务器处理数据，再把结果返回给客户端」。

3. 用肯定句。 少用否定，不用双重否定。

   • 不这样写：「不是不能用」。这样写：「可以用，但有一个条件」。
4. 条件放在动作前面。 先写「如果……」，再写「就……」。
5. 步骤用编号列表。 每步以动词开头，一步只做一个动作，尽量不超过 20 个字。不写「请」「您」「用户需要」。
6. 每个代词都要能找到它指的东西。 「它」「这」「该」有歧义时，换回名词。

段

1. 一段只讲一个主题，不超过 5 句。 第一句写结论，后面写理由和细节。
2. 3 项以上的并列内容用列表。 不把一串条件塞进一句。

删掉的东西

1. 删掉铺垫、客套和填充语。 例如：

   • 「值得注意的是」「需要指出的是」「总的来说」「众所周知」
   • 「好问题！」「希望这对你有帮助」
   • 「非常」「极其」「强大的」「无缝」这类不带信息的形容词
   • 把结论再说一遍的结尾段

必须保留的东西

1. 内容不删。 每个事实、数字、条件、例外、限定词都要留下。原文说「通常」，改写后也要说「通常」。改写只拆句子、换说法、调顺序。
2. 不改的东西： 代码、命令、文件路径、报错原文、引文、专有名词、公式。

强度

• 常规（默认）： 执行全部规则。句长是目标，不是硬上限。读起来像人写的。这就是 Karpathy 说的「80% of the way to ASD-STE100」。
• 严格： 用户说「严格」「按 STE 来」时使用。句长按硬上限执行。每个术语都给定义。全文不用比喻。

怎么改写

1. 先读完原文，列出它要传达的每个事实和条件。
2. 逐句检查。找出每句违反了哪条规则。
3. 改写这一句。对照第 1 步的清单，确认没有丢东西。
4. 改完整段后再读一遍。拆句时容易产生新的「它」和新的长句。

难懂的内容可以先用英文按 STE 思路写骨架，再按上面的规则转成中文。英文 STE 的约束更成熟，模型也更熟悉。

输出格式

• 默认只输出改写后的文字。不加开场白，不说明用了什么规则。
• 如果改写时为了不丢内容而保留了长句，在末尾加一行：保留原样：……（原因）。
• 用户要求「对照」「改了哪些」「为什么这么改」时，输出表格：原句 | 改写 | 依据的规则编号。

交付前自检

• [ ] 每句只讲一件事吗？有没有超过 25 字还能拆的句子？
• [ ] 同一个东西是不是始终用同一个词？
• [ ] 每句的主语都清楚吗？
• [ ] 有没有删掉原文的事实、数字、条件或「通常」「可能」这类限定词？
• [ ] 有没有残留「值得注意的是」这类填充语？

更多改写示例见 [references/examples.md](references/examples.md)。

限制

本 skill 让文字好懂，不让文字正确。原文有错，改写后的错误会更容易被相信。需要准确性的内容，另外核对事实。