Bug 修复 Prompt 模板

一个结构化的 Bug 修复 Prompt 模板,帮助你向 AI 清晰描述现象、预期与上下文,从而更快定位根因并得到最小改动的修复方案。

修 Bug 时,信息给得越清楚,AI 定位越准。下面的模板帮你把关键信息一次说清。原理参考 Prompt 写法指南

标准模板

现象:<复现步骤,第几步出现什么错误>
错误信息:<完整报错或日志>
预期行为:<本该发生什么>
环境:<语言/框架版本、运行环境>
相关代码:<文件路径或粘贴片段>
请先分析可能的根因(可列出几种),再给出你认为最可能的,
并提供最小改动的修复方案。不要顺手做无关重构。

当你也不确定问题出在哪

我不确定问题出在哪里。现象是 <描述>。
请帮我缩小范围:列出可能相关的位置,并告诉我需要补充哪些信息
(日志、输入、配置)才能进一步定位。

修复后做验证

请说明这个修复为什么能解决问题,可能影响哪些地方,
并补充一个能覆盖该场景的测试,防止回归。

使用建议

  • 先给现象再要方案:不要一上来就问“怎么改”。
  • 附上完整报错:截断的日志会显著降低定位准确度。
  • 限制改动范围:明确要求“最小改动”,避免引入新问题。

如果你用 CLI 工具,可参考 Claude Code 常用命令整理 配合使用。