很多人吐槽程序员宁愿写几千字 `CLAUDE.md` 喂给 AI,也懒得给同事写行注释。这真不是自私,而是极其理性的职场 ROI 算计。
给人类写文档是妥妥的亏本买卖。你得花大把时间帮对方补背景,结果他们根本不看,转头还是在会议上让你“口述一下”。写得越好,你越容易变成随时被白嫖的免费客服,反而耽误写代码拿晋升。
但给 AI 写文档,回报是即时的。你多写一分清晰的逻辑,AI 就能在几秒钟内吐出更精准的代码。这种即时正反馈,人类同事给不了。
未来的底层研发逻辑变了:别再试图写人类友好的文档。最优解是直接写 AI 最容易吞噬的信息。人类把规则喂给 AI,再让 AI 去给不同水平的同事做个性化翻译。让机器去应付人类的怠惰,才是真正解放生产力。
blog.plover.com/tech/gpt/documentation-wins-2.html