Doc Writing

这个 skill 做两件事。先从维护者那里拿到只有他们才有的材料：事实、读者是谁、取舍的立场。 再把这些材料写成读者读起来省力的文档。第二步做的事和翻译一样：意思一个字不改，说法换成 读者顺着读下去就能懂的那种。要做好第二步，先要知道读者是怎么读的，以及模型为什么默认 写成读者难读的样子。

读者是怎么读的

读者一次只能拿着几件事。每读一句，他要把这句挂到已经拿着的某件事上；挂得上，这句就变成 他的，挂不上，他要么先悬着，要么自己去补中间缺的那一步。所以一句话应该从读者已经有的 东西出发，只加一样新的。每句都是全新事实的文档，读者没有落点，读几句就丢几句。

读者要在读的过程中判断什么重要。散文里能传递这个判断的信号只有几种：篇幅（作者花了多少 字）、重复（同一件事用后果、例子、数字再说一遍）、位置（一段的第一句）、明说的立场 （“不建议”“最常见的错误是”）。每段差不多长、每句停在同一个抽象层的文档把这些信号抹平了， 读者只能逐句自己判断哪句重要。