程序员愿为Claude写文档，却不愿为同事写

马克·多米纳斯（陶敏修）mjd@pobox.com档案：副主题：评论已禁用2026年3月9日星期一程序员将为Claude写文档，但不会为彼此写几天前我讲述了一个常见的抱怨：我不断看到程序员说，人们愿意为Claude编写详细的CLAUDE.md和PROJECT.md文件，

却不愿意为同事写这些，这让他们很生气。对于较大的项目，我开始让Claude维护一份交接文档，我可以让下一个Claude阅读，说明我们计划做什么、已经做了什么以及其他相关信息。然后，当我关闭一个Claude时，我可以让下一个读取文件以跟上进度。

然后我让Claude n+1为Claude n+2更新它。在看到这个常见抱怨足够多次后，我有了一个愉快的灵感。我之前一直在每个项目结束时扔掉Claude的交接文档。为什么要那样做呢？把文件复制到仓库并提交并不麻烦。

未来某个人，想知道发生了什么，可能会幸运地用git grep找到正确的文档并学到一些有用的东西。

我有点迟钝，所以直到本周我才想到一个更好的版本：在项目结束时，我现在让Claude从头开始写一份详细但高层次的解释，说明我们正在解决什么问题以及我们做出了哪些改变，然后我提交它。不仅仅是运行笔记，而是对整个事情的结构化概述。

我仔细审查这些概述，并在签入之前进行必要的编辑。这是我在提交上的签名，也是我收到薪水的银行账户，所以没有任何东西进入仓库是我没有仔细阅读和理解的，就像Claude是我监督下的人类程序员一样。但Claude的解释并不需要太多编辑。

Claude最近的项目总结和我自己写的差不多，也许稍差一点，也许稍好一点。但写起来只花了十秒而不是一个小时，而且审查也不需要一个小时。

上次我必须解决的严重问题是，Claude使用了之前的一份相关报告作为模型，而之前的报告有一段我在最后添加的段落说：# 批准人Claude从我们对这个问题的讨论中提取了这些注释。Mark Dominus已阅读、审查、编辑并批准这些注释。

Claude的新文档末尾有一个相同的部分。哎呀！幸运的是，当我看到它的时候，这已经是事实，所以我不必删除它。我让Claude在CLAUDE.md中添加一句话，告诉它不要再这样做。我今天的建议是：如果你让Claude记笔记，完成后把它们签入仓库。

这大概不会有害，而且可能会有帮助。让Claude写一个项目总结，然后把它签入仓库。也许这很明显？但对我来说并不明显。我还在适应这个新世界。

[类别/tech/gpt中的其他文章] 永久链接