用 Bug Report Packet 调试 AI 生成代码
把 AI 生成应用里的混乱报错整理成 Cursor、Claude Code、Codex、ChatGPT、Lovable、Bolt、Replit Agent 或开发者能接手的调试包。
AI 生成代码报错时，不要只把最后一行错误粘给另一个 prompt。真正有用的调试交接应该包含准确错误、期望行为、实际行为、复现步骤、最近 AI 改动和已尝试操作。
Bug 调试信息包生成器 可以在本地整理这些上下文，适合 Cursor、Claude Code、Codex、ChatGPT、Windsurf、Lovable、Bolt、Replit Agent 和人工 issue。
为什么 packet 比裸错误更好
原始错误通常不完整。它很少说明：
- 原本应该发生什么
- 用户实际做了什么
- 问题出现在本地、预览环境还是生产环境
- bug 前最近一次 AI 改了什么
- 哪些修复已经试过
没有这些上下文，AI agent 很容易重写无关文件、重复失败方案，或修错问题。
应该包含什么
最小调试包包含：
| 段落 | 内容 |
|---|---|
| Context | 工具来源、bug 类型、环境 |
| Error | 准确 console error、stack trace、build log 或 API response |
| Expected | 什么结果算修好 |
| Actual | 用户实际看到的坏结果 |
| Reproduction | 从干净状态开始的编号步骤 |
| Recent AI change | prompt 摘要、改动文件或 agent note |
| Already tried | 已经试过的命令、重构建、编辑或 prompt |
API bug 还要包含 method、URL、headers、payload、response status 和 server log。可以参考 DevCove 的 API 调试指南。
把 packet 当作下一轮 prompt
填写后，要求下一轮 AI 给出小而安全的补丁：
Use this bug report packet to identify the likely cause.
Ask for missing information before guessing.
Propose the smallest safe patch.
Do not rewrite unrelated files.
Explain how to verify the fix.
这样的 prompt 能约束 AI 不乱改。修完后，回到 AI 编程工作流检查清单，继续验证 build、env vars、review gates 和部署行为。