程序员会为Claude写文档,但不会为彼此写
2026年3月9日,星期一 程序员会为Claude写文档,但不会为彼此写。 几天前,我回顾了一个普遍的抱怨:我总是听到程序员说,他们感到愤怒的是,人们愿意为Claude编写详细的CLAUDE.md和PROJECT.md文件,但却不愿意为他们的同事编写。对于较大的项目,我让Claude维护一份移交文档,以便我可以让下一个Claude阅读,说明我们计划做什么,已经完成了什么,和其他相关信息。然后当我关闭一个Claude时,我可以让下一个Claude阅读该文件以跟上进度。然后我让Claude !!n+1!! 为Claude !!n+2!! 更新它。 在看到这个普遍抱怨足够多次后,我有了一个快乐的灵感。我一直在项目结束时扔掉Claude的移交文档。为什么要这样呢?将文件复制到代码库并提交是毫无问题的。未来某人,如果想知道发生了什么,可能幸运地找到正确的文档,并学到一些有用的东西。我有点慢,所以直到本周我才想到了这个更好的版本:在项目结束时,我现在要求Claude从头写一份详细但高层次的解释,说明我们正在解决什么问题以及进行了哪些更改,然后我提交这个文档。不仅仅是运行记录,而是整个事情的结构化概述。我仔细审查这些概述,并在检查之前根据需要进行编辑。因为这是我在提交上的签名,也是我银行账户收到的薪水,所以任何进入代码库的东西都是我仔细阅读并理解的,就像Claude是我监督下的人类程序员一样。但Claude的解释不需要太多编辑。Claude最近的项目总结差不多和我自己写的一样好,可能有点差,也可能有点好。但它花了十秒钟写,而不是一个小时,审查也没有花一个小时的时间。上次我必须修复的严重问题是,Claude使用了一个相关报告作为模板,而之前的报告在最后有一段我添加的文本,说: # 批准 - Claude从我们对这个问题的讨论中提炼了这些笔记。Mark Dominus已阅读、审查、编辑并批准了这些笔记。 Claude的新文档在最后有一个相同的部分。哎呀!幸运的是,当我看到它时,这是真的,所以我不用删除它。我让Claude在CLAUDE.md中添加一句话,告诉它不要再这样做了。 我今天的建议是:如果你让Claude写下笔记,请在完成后将其检入代码库。它可能没有坏处,可能会有帮助。让Claude写一份项目总结,然后将其检入代码库。也许这很明显?但对我来说并不明显。我仍在适应这个新世界。[其他分类下的文章 /tech/gpt]永久链接
本站免费、广告极少。如果觉得有帮助,可以请我们喝杯咖啡 —— 任何金额都对持续运营有实际帮助。
☕请我喝杯咖啡