程序员的奇怪现象:愿意给AI写文档,却不愿给同事写

最近看到一个挺有意思的观察：程序员们为了让 Claude 更好地理解项目，会花时间写详细的 CLAUDE.md 和 PROJECT.md 文件，但同样的精力，他们却不愿意投入到为同事写文档上。

这个现象乍一听有点荒诞，但仔细想想，背后的心理其实挺好理解的。

为什么愿意给AI写文档？

即时反馈的魅力

给 AI 写文档有种立竿见影的满足感。你写完描述，Claude 马上就能理解你的意图，开始干活。这种即时的正反馈让人上瘾——就像玩游戏时的经验值提升，每一次投入都能看到明确的回报。

没有人际压力

更重要的是，AI 不会批评你的文档写得不够好，不会抱怨格式不规范，也不会在团队会议上指出你遗漏了什么重要信息。这种”无压力环境”让很多程序员感到轻松。

控制感更强

当你和 AI 协作时，你是绝对的主导者。文档的详细程度、表达方式完全由你决定。而给同事写文档时，总是要考虑各种受众需求，平衡不同人的理解水平。

一个聪明的转换思路

程序员 Mark Dominus 提出了一个巧妙的解决方案：既然大家已经在为 AI 维护这些文档了，为什么不把它们保存下来给人看呢？

这个思路的精妙之处在于，它没有试图改变程序员的行为习惯，而是顺势而为，把已有的产出最大化利用。

具体怎么做？

1. Claude 交接文档

对于复杂项目，让 Claude 维护一个”交接文档”——记录计划、进展、关键决策。当你结束一个 Claude 会话时，这个文档能帮助下一个 Claude 快速接手。

这其实就是我们一直说要写但从来不写的”工作日志”。

2. 项目总结

项目结束时，让 Claude 写一份高层次的总结：解决了什么问题，做了哪些改变，为什么这样做。然后把这个总结提交到代码仓库。

3. 质量把关

Mark 会仔细审查 Claude 生成的文档，必要时进行编辑。他发现 Claude 的项目总结质量”与他自己能写的差不多，可能稍差一点，也可能稍好一点”。

关键是：Claude 花 10 秒写完的东西，他自己可能要花一个小时。

这种做法的深层价值

降低了文档维护的心理门槛

传统的文档写作让人望而却步，因为它意味着”额外的工作”。但如果文档是协作过程的自然产物，心理负担就大大降低了。

保持了文档的时效性

最好的文档是在开发过程中同步产生的，而不是事后补写的。与 AI 协作时产生的文档天然具备这个特点——它们记录的是”当时的思考”，而不是”事后的回忆”。

意外提升了代码质量

当你需要向 AI 解释复杂逻辑时，往往会发现自己思路中的漏洞。这种”橡皮鸭调试”的效应，让代码本身也变得更清晰。

一些实用建议

从小处开始

不要试图一次性建立完整的文档体系。从保存与 AI 的重要对话开始，逐步形成习惯。

建立简单的流程

在项目文件夹里创建一个 ai-docs 目录，把与 AI 协作产生的有价值文档都放进去。定期整理，去除过时内容。

让 AI 帮你写文档模板

既然 AI 这么擅长理解你的意图，不如让它帮你设计文档的标准格式。这样以后的文档会更加规范统一。

不要完美主义

记住，”有文档”比”完美的文档”更重要。即使是 AI 生成的、略显粗糙的文档，也比没有文档强太多。

写在最后

这个现象其实反映了一个更大的趋势：AI 正在改变我们的工作方式，包括那些我们以前觉得”麻烦”的部分。

与其感叹程序员”重 AI 轻人”，不如思考如何利用这种新的协作模式，让团队协作也变得更高效。

毕竟，好的文档不在于是谁写的，而在于它能否真正帮助到需要的人。如果 AI 能降低文档创建的门槛，让知识传承变得更容易，这难道不是一件好事吗？

下次当你和 Claude 聊完一个复杂问题后，不妨按个 Ctrl+S，把这些对话保存下来。说不定几个月后，你会感谢现在的自己。

本文由 Felix、openclaw 和 claude-sonnet-4 共同创作