面向AI写文档2026年10月7日提问

怎么面向AI写文档?有没有具体案例解释一下?是不是写的越多越好?怎么让文档具备足够的泛用性?

面向 AI 写文档,关键不是写得多,而是把判断标准写成 AI 能读到的材料,并按当前任务只加载相关部分。

AI根据立正公开的文章和视频整理,不是他本人回复。重要的判断,请回到出处核对。

决定输出质量的是 AI 看到了什么

材料里的观点

AI 产出总是“差点意思”,常见原因不是提示词写得不够漂亮,而是你的审美偏好、判断原则、验收标准、过去的取舍全在你脑子里,一条都没给它。就像让一个聪明的新员工写方案,你只说“帮我写个方案”,改五轮还是不对——不是他不聪明,是他不知道你要什么。对应做法是把项目规范、风格指南、验收标准、历史决策、约束条件写成 AI 可读取的文档;对 AI 来说,读不到的信息等于不存在。个体创业者的品牌调性、写作风格、对客户的理解都是隐性知识,写出来这件事本身就有价值,很多人写的过程里才发现自己的标准从没被想清楚过⁠1,2。

文档不是越多越好,要分主线与参考

材料里的观点

上下文不是越多越好,关键是信噪比。有一个具体案例:一个项目主页的仓库一度积累了很多 guideline,每收到一轮反馈就加一条原则,最后模型努力同时满足所有要求,产出的页面反而越来越平均——小标题、卡片、解释、结构一个都不少,但主线越来越弱。后来把材料分成两类:价格、权益、事实、来源边界和当前页面属于必须遵守的 active contract;旧版论点、优秀案例、写作原则和视觉参考只是 reference,需要时才读。上下文互相竞争时,模型通常会取平均,所以更有效的做法是先有一个足够强的主线,再只加载当前决策需要的材料⁠3。

泛用性来自写清目标、坑和工具

想让文档能复用到不同任务,可以按三个元素组织:成功标准是什么、经常踩的坑有哪些、需要什么专用工具。这样 AI 拿到的不只是背景,而是判断“做到什么算对”的依据。配合结果导向的指令——说清输出长什么样、满足哪些标准、不能碰哪些边界,而不是逐步遥控它先做什么再做什么。泛用性不来自把文档写厚,而来自把判断标准写清楚,让 AI 在新任务里也能用同一套标准判断⁠4,2。

关于“写多少”的取舍,材料给的是主页迭代这一个案例,其他场景下的合适粒度需要自己试。

出处

  1. 1AI 用得好的人与普通人的5个差距,和背后具体技术原因|非技术岗位版

    超线性学院 · 会员2026-04-13

    从个体视角解释隐性知识显性化的价值,适合非技术岗位读者对照自己的情况。

  2. 2AI User 与 AI Builder 的 5 个差距,和背后具体技术原因 | 科技大厂打工人版

    超线性学院2026-04-10

    讲清了 Document-First、信噪比和结果导向指令三个概念,适合理解为什么文档决定输出质量。

  3. 369 个版本,99 次 commit后,我做好了Stay Superlinear的主页

    超线性学院2026-07-18

    有主页迭代的具体案例,说明上下文过多导致产出变平均,以及 active contract 与 reference 的分法。

  4. 4课代表和鸭哥工作的实况 | how the sausage is made

    会员视频2026-05-29

    提到写 skill 的三个元素:目标、常踩的坑、专用工具,适合理解文档怎么组织才可复用。

你也有想问的?

卡住的时候,问问立正:回答只从立正讲过、写过的东西里来,每一段都能点回原文。

问类似的问题

也可以接着问:

所有问题 →