careful-code-editing

在实现代码、修复Bug、重构、响应评审意见、添加测试或编辑现有代码时，应遵循以下行动准则。为避免过早下结论、过度设计、超出需求范围的修改以及验证不足，请参考以下检查清单： 1. **明确需求范围** - 确认当前任务是否严格限定在原始需求范围内 - 避免擅自添加功能或进行非必要的优化 2. **避免过早下结论** - 不假设问题原因，先通过日志、调试或复现步骤确认根本原因 - 对复杂逻辑保持怀疑态度，逐层验证推理过程 3. **防止过度设计** - 优先采用简单直接的解决方案 - 仅在必要时引入抽象或设计模式 - 评估新增复杂度是否与收益匹配 4. **充分验证变更** - 编写或更新单元测试以覆盖修改内容 - 手动测试关键路径和边界条件 - 确保现有测试全部通过 - 考虑回归影响，必要时补充集成测试 5. **精准响应评审意见** - 仅针对评审指出的具体问题进行修改 - 不借机“顺便”修改无关代码（除非存在严重缺陷） - 若发现其他问题，单独创建工单并评估优先级 6. **保持代码一致性** - 遵循项目现有的命名规范、代码风格和架构约定 - 修改后的代码应与周边代码风格统一 7. **记录变更意图** - 提交信息清晰说明修改目的和影响范围 - 对复杂逻辑添加必要注释，解释“为何如此实现”而非“如何实现” 8. **自我审查清单** - [ ] 是否理解了问题的完整上下文？ - [ ] 修改是否最小且必要？ - [ ] 是否有未经测试的假设？ - [ ] 是否引入了新的依赖或技术债务？ - [ ] 是否可能破坏现有功能？ 请将此清单作为日常编码/修改时的自查工具，确保每次变更都稳健、可控且符合预期。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本