什么是提示的文档化？为什么这么写

一条调好的 AI 提示词只活在某个人的对话框里，等于没调过——提示的文档化，指把每条提示的写法、用途和来历写下来、存起来、可查找，让个人经验变成团队资产。

先把词拆开

「提示」是那些反复使用的问法，「文档化」是给它建档的动作。一份合格的提示文档通常记四件事：这条提示解决什么问题、完整写法是什么、在哪些模型上试过、改过哪几版。它回答的不止「怎么写」，还有「为什么这么写」——后者恰恰是标题里那半句的分量：知道来路的模板，别人改起来才有底气。建档的粒度也有讲究：一模板一档，别把几十条提示塞进一个文档里互相打架；档名直接用用途命名，检索时按用途找，比按日期翻快得多。它和随手收藏也不同：收藏是「觉得有用先存着」，建档是「确认有用、写清怎么用」，差别就在后者多写了那几行说明。

一个办公室的比方

像老会计的账簿附注。光有数字没用，每笔大数旁边注明来龙去脉，半年后翻回来照样看得懂。提示文档就是给每条模板写附注：当时为什么这样措辞、踩过什么坑。比方不成立的地方在于：账簿记的是已经发生的确定性事实，提示文档还承担「教新人上手」的任务，写得要让没经历过那几轮调试的人也能照着用，详略取舍因此更讲究。写的时候记住一个视角转换：读者是三个月后的自己，或者从没见过这条提示的同事——凡是「当时自然就懂」的背景，都值得补一句话说明。

写下来带来什么

直接的好处有三个。其一，提示复用有了底座——模板连来历一起共享，别人敢放心用；其二，团队提示规范不必凭空编，直接从文档里挑经过验证的条目收编；其三，跑A/B 提示时，两版的历史表现有处可查，比较不再靠回忆。一句话，写下来，经验才从个人记忆变成公共资产，人走了，资产还在。还有一层隐性好处：写的过程本身就是复盘。一条提示说不清用途，多半是它真没想清楚用途，文档化会逼着你把模糊的认识整理明白。

怎么起步

不必追求大而全。挑三条最常用的提示，各写五行说明：用途、写法、验证情况、一条教训，存进共享文档就算起步。验证情况怎么填？用讯飞星火试一遍，再换豆包试一遍，把各自表现记两行，这比一句「效果不错」有用得多。之后每改一版补一行，季度末回头翻一遍，把失灵的条目标出来。文档化难的地方不在写，在坚持补——配一条团队规矩，改提示必记一笔，习惯就立住了。字段可以再简，但「验证」和「沿革」两个字段别省——前者让人敢用，后者让人敢改，这两样齐了，文档才不是摆设。

提示文档最小字段

• 用途：一句话说清解决什么问题
• 写法：当前版本的完整提示
• 验证：在哪些模型上试过、表现如何
• 沿革：改版原因，一行一条

一句话带走：经验写成文档才算数，先做提示的文档化。

关于提示的文档化的三个常问问题

• 它和个人笔记有什么区别？：个人笔记写给自己看，提示文档面向团队，字段齐全、别人能照着用才算合格，这是门槛线。
• 多久更新一次？：跟着改动走，每改一版补一行即可，不必定期空转，也不用攒着一起补。
• 换了工具模型怎么办？：在「验证」字段补新模型的表现，旧记录保留，方便前后对比，退化一眼可见。

文档化做久了会有复利：新人入职第一周就能照着文档跑通核心任务，老人离开也不带走绝活，团队的 AI 用法第一次变得可继承、可交接。