sharp-writing

精炼写作

写得精炼：每个词都要有用。以下规则适用于所有正文和 Markdown。

先找出核心

动笔前，先找出观点的核心。明确表达核心，并把它说好。

原则

• 精炼、准确、简洁。直奔主题。越简短越好。
• 用语通俗。句子要短而清晰。
• 不要凑字数。避免冗长的指令和填充内容。
• 尊重读者。语气不要咄咄逼人或专断，也不要把读者当孩子。要让重要内容更醒目。
• 保持正式语体。

仔细斟酌每个词

选择能准确表达意思的词。优先使用常用词，只有在复杂或专业的词更准确时才使用。

保持正式语体

保持专业，但不要生硬。写完整的句子，不要省略开头。避免俚语、随意的行话和表情符号。

像组织代码一样组织文本

好的文本就像好的代码：

• 避免重复。
• 像重构代码一样重构文本，让每个观点都组织得当、表达清楚。

一个观点用一个句子表达。一个问题用一个段落说明。一个问题需要多个段落时，为其添加章节标题；复杂观点也要拆分成小观点。不要把多个观点塞进一个句子，也不要把多个问题塞进一个段落。用冒号和破折号串联分句，就是在塞内容，应拆开来写。

直接呈现路径，不要写绕路过程。写作就像攀登一座未知的山：你会四处探索、折返寻找道路，最后从山顶看到直达路线。写出这条路线。读者想看的是直达路线，而不是寻找路线的过程。

多用肯定表达

陈述事实，不要陈述事实并否认其反面。否定句会让读者反向理解；双重否定则要反向理解两次。

删除重复的否定

一种常见的惯性写法是先肯定，再用否定重复同一个意思：“X 是 A，不是 B”，而 B 只是 A 的缺失。删掉否定的部分。

说完最后一个事实就停

信息结束时就结束。不要用一句话重申观点、总结教训，或为刚写的内容辩解。保留结尾句之前，先确认它是否带来新的事实或指示。如果它只是在强调、总结或安抚，就删掉。

仅在必要时举例

只有规则难以理解时才举例。能独立说明问题的正文无需举例。

需要举例时，编写一个中性的案例。

Markdown

在 Markdown 文件中，每个正文段落都写在同一物理行上。不要按固定宽度换行。

破折号：两类读者的唯一风格差异

破折号（—）是面向两类读者时的主要风格差异。

• 面向人类：仅将破折号用作视觉分隔符。
• 面向 AI Agent：也可以在正文句子中使用破折号，但准确、直截了当的句子通常无需使用。

以下用法对两类读者都适用，作为视觉分隔符：

• key1 — 描述 1
• key2 — 描述 2

以下用法仅适用于 AI Agent，在句子中使用：

先陈述主要观点 — 再在破折号后补充限制条件。

重读并修改

写入文件的文本并非定稿。重读一遍，然后放手修改：重写、纠正、精简。

编辑就是重写

将新内容融入现有句子；只有现有句子都无法承载时才另行添加。好的修改应让文本保持原样简短，或变得更短。