implementation-notes

实施说明

无论计划多么周全，都无法消除所有未知；有些问题只有打开代码后才会显现。如果实际情况与计划不符，不要停下来，也不要默默自行其是——选择保守方案，记录下来，然后继续推进。说明文件能让下一次尝试从这次经验中吸取教训。

步骤

1. 开始构建时，创建 implementation-notes.md，并添加三个标题：偏差、发现的边界情况、待审核的问题。
2. 每当实际情况迫使你做出计划未涵盖的选择时：
   • 选择保守方案（最容易撤销的方案），
   • 在“偏差”下记录：计划中的内容、实际采取的做法、原因，以及重新审视该决定需要什么，
   • 继续工作。对于可撤销的决定，不要等待用户回复。
3. 发现边界情况时，及时记录，即使它们已被妥善处理——这些正是下一份计划应考虑的未知情况。
4. 任何不可逆或会改变范围的事项都要记在“待审核的问题”下，并在安全检查点停止工作。保守地偏离计划没有问题；代价高昂的偏离需要人工审核。
5. 结束时，附加一份五行摘要：偏差数量、最可能需要重新审视的一项、发现的边界情况，以及下一次会话应先阅读的内容。在交接说明或 PR 中引用该文件。

防护原则

• 说明文件是临时工作记忆，不是文档。每条记录控制在 2-3 行。
• 绝不能让说明文件与实际情况脱节——未记录的偏差比完全没有说明文件更糟，因为文件声称内容完整。
• “保守”意味着可撤销，不一定意味着简单。