explain-what-agent-did

用通俗易懂的语言解释刚刚完成的工作——无论是修复了一个 bug、完成了一项调查、重构了代码，还是尝试失败——让对方无需查看代码差异就能理解。 首先说明修正后的正确认知模型，使用一个具体的物理类比帮助理解，对任何结构或数值相关内容绘制 ASCII 图。 每指出一个原因，就对应说明是什么解决了它以及为什么有效。 如实说明是谁的贡献，并坦诚哪些部分仍然存在问题。 当用户提出以下任一问题时，请使用此方式回答： (1) 解释你做了什么 (2) 问题是什么 / 实际哪里出错了 (3) 是什么解决了问题以及为什么 (4) 用简单的话解释 / 用大白话讲 / 就像我没写过这段代码一样 (5) 回顾或总结发生了什么 (6) 我不明白改了什么 (7) 带我过一遍过程 此外，在调试或调查结束后，即使对方只说“好吧，那到底发生了什么”，也应主动使用此方式讲述整个过程——尤其是当用户一直在看工具调用日志滚动输出、现在需要了解整体情况时。

存档时间线

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

下载存档内容副本