提交描述作为思考工具

在人工智能时代之前，我为重大变更编写了相当长的提交描述（或提交正文）。我花了大约五到十分钟的时间来起草并重读它们，以确保我没有错过任何重要的内容。我这样做有几个原因。我想包含所有有用的信息，这样读者就不必在多个地方寻找它。我想解释一下是什么，更重要的是，为什么。 “内容”总结了通常不言自明的变化，但它为解释“原因”提供了一个起点。有时，我会用第一人称来写，就像我正在为某人起草一条信息：“我这样做是因为……”，“我这样做直到我们……”等等。然后我继续解释原因，以便其他人，最重要的是未来的我，更容易理解为什么我们做出了这样的改变。这是一次很好的锻炼。这不仅仅是编写提交消息和描述。写作过程本身可以帮助我反思我所写的代码。我重新阅读了代码并总结了更改。在此过程中，我倾向于重新评估决策，有时这会带来不同或更好的改变。现在我们正处于代理编码时代，从代码到提交描述的所有内容都是由人工智能编写的。关于我们是否应该阅读人工智能编写的代码，以及这在可读性方面有多困难，存在着巨大的争论。我发现困难的部分是阅读和理解人工智能编写的提交描述。代理可以为他们所做的更改编写提交消息。但他们可能不具备跨不同沟通和项目管理工具的完整背景。其中一些也可能处于离线状态。当人工智能不知道“为什么”时，它会提出自己的推理。我觉得这很危险。当我们稍后阅读时，可能会觉得没有道理，因为真正的原因完全不同。一种显而易见的解决方案是通过聊天或工具为代理提供所需的所有上下文。这有助于解决捏造推理的问题。代理人现在可以清楚地解释“为什么”。但这并不能解决另一个问题。具有正确上下文的代理将编写令人信服的提交消息。但只有我可以验证代码是否按照描述进行操作。因此，我要做的就是：自己编写提交消息和描述。这就是原因。自己写一份提交描述可以帮助我反思人工智能所做的改变。这也是检查一切是否按预期进行的一种方法。如果我无法解释“为什么”，那么我正在运送一些我不理解的东西，如果以后出现问题，将很难解释或修复。这又回到了旧的引述。如果你无法解释它，那么你就没有理解它。提交描述在这里再次充当思考工具。有些部分，比如“我会这样做，直到我们……”，是带有退出标准的临时决定。我们有时会设置退出条件，人工智能无法从代码或其他工具中推断出它们，因为它们通常不会写在任何地方，因为它们看起来太明显而无法提及。但是编写提交消息会迫使我完成该句子，并且它可以帮助未来的读者决定是否保留该更改。代理可以编写代码和描述。但写下原因可以让你知道你是否理解你所交付的内容。