给人写文字

给 agent 读的文档用 writing-for-agents。

开始前

先读事实源：.agents/product-marketing.md、项目的 PRODUCT 与 README、当前页面或原稿。项目有风格指南时以它为准，作者自己的习惯（比如爱用破折号）不算 AI 腔。只补问会改变成稿的缺口：读者是谁、读完要做什么、有哪些可核实的事实。信息够就直接写。数字、评价、能力只写有来源的；没有事实支持时降低主张强度。

写网站或产品的营销页（首页、落地页、定价页、功能页、产品描述）时读 营销页。

写法

• 先给判断，再给依据；一段只推进一个论点。
• 同一个东西从头到尾用同一个名字，不为避免重复轮换近义词。
• 用读者自己的说法，不用内部术语；保持项目既有语气。

逐项避开的 AI 腔

1. 翻案腔：先立一个读者没有的误解再推翻——「不是 A，而是 B」「与其说……不如说」「看似……实则」「你以为……其实」、"It's not X, it's Y"。直接说 B。
2. 提示语：「一句话总结：」「核心在于：」「原因有两个：」「说白了」「先说结论」。删掉提示语直接写；前半句承接上文时保留，只把冒号换成句号或逗号。
3. 破折号和分号当万能停顿：换成句号或逗号；破折号只留给插入解释。
4. 罗列与同构：一句里顿号连起三项以上；相邻三句同一骨架（「能不能……？能不能……？能不能……？」）；英文 "X, Y, and Z" 三连。能概括就概括，必须保留时改掉其中一项的句式。
5. 段段衔接：每段开头都接住上一段（「这也解释了为什么」「从这个角度看」「然而，」「此外，」）。话题跟着材料走，只留承担因果的衔接。
6. 翻译腔：中心词前超过十五字的定语拆成两句；「对于……来说」「就……而言」「当……时」后面的主语本来就是它时去掉外壳。
7. 英文套话：That being said、It's worth noting、At its core、In today's … landscape、delve、段首 In conclusion、成串的 moreover/furthermore。

以下看着像 AI，实测人写得一样多甚至更多，照常用，改稿时也不删：小标题编号、首先/其次、设问与问句小标题、「这意味着」、比喻、名词化、赋能/闭环这类词、长短不参差的句子。

改稿

用户给了原稿时只改命中处：观点、事实、数字、引语和限定词（「可能」「通常」）原样保留，标题层级、段落顺序、列表、引文、代码不动，不顺手润色，不为节奏改句长。完成标准：每处改动都对得上上面某一条，对不上的已撤销。

输出

先给可直接使用的成稿；用户没要求就不附写作讲解。