在AI出现之前，我为重大变更编写了相当长的提交描述，花五到十分钟起草并重读它们。我这样做是为了包含所有有用的信息，解释是什么和为什么，并帮助未来的我理解推理过程。以第一人称写作，比如“我这样做是因为……”，使过程更加个人化和反思性。这不仅仅是关于信息；写作帮助我重新评估代码决策，有时会带来不同或更好的变更。

现在，随着代理编码的出现，AI编写代码和提交描述。争论集中在阅读AI编写的代码上，但我发现AI编写的提交描述更难。代理缺乏分布在各种工具中的完整上下文，当它们不知道“为什么”时，它们会编造推理，这是危险的。通过聊天或工具给代理所有上下文有助于它们清楚地解释“为什么”，但这并不能解决验证问题：只有我能确认代码与描述匹配。

所以，我自己编写提交信息。这迫使我反思AI所做的变更，并确保一切符合预期。如果我无法解释“为什么”，那我就是在发布我不理解的东西。提交描述作为思考工具，帮助我完成像“我这样做直到我们……”这样的句子，并带有AI无法推断的退出标准。编写“为什么”揭示了你是否真正理解你正在发布的内容。