混亂 coding assistant 對話怎麼整理成 bug report？一個實際範例
以一段 AI debug 對話為例，把混亂 coding session 整理成有重現步驟、證據、範圍、假設和任務清單的 bug report。
2026年5月14日
AI coding assistant 對話常常很亂：一開始猜錯方向，中途貼了 log，後面又試了幾個 patch。這些內容有用，但不能直接丟進 GitHub issue 或 Jira。
Highlight Reel
把 AI debug 對話整理成可執行 bug report
保留重現步驟、證據、已試過方案和下一步，讓工程師或下一個 coding agent 能接手。
好的 bug report 要把混亂對話整理成預期行為、實際行為、重現步驟、證據、影響範圍、可能原因和任務清單。
先講結論
從 AI coding session 轉成 bug report 時，保留：
- 預期行為
- 實際行為
- 重現步驟
- AI 對話裡的證據
- 需要檢查的影響範圍
- 可能原因
- 已排除的方向
- 任務清單和仍未知的地方
整理後的 bug report
# Bug report
## 預期行為
## 實際行為
## 重現步驟
1.
2.
3.
## AI coding session 裡的證據
- Log：
- File path：
- Test output：
## 影響範圍
## 可能原因
## 已排除方向
## 任務清單
- [ ]
## 仍未知轉換清單
| AI 對話裡的內容 | Issue 裡的版本 |
|---|---|
| 一堆猜測 | 可能原因 + 信心 |
| 散落 log | evidence 區塊 |
| 試過的 patch | 已排除方向或任務清單 |
| 長段討論 | 選出的對話片段連結 |
| 模糊下一步 | checkbox 任務 |
什麼要從 coding assistant 保留
保留能縮短調查時間的東西：重現步驟、錯誤訊息、檔案路徑、測試結果、已排除原因、可疑範圍。刪掉反覆試錯和沒有證據支撐的推測。
可以給另一個 AI agent 用嗎
可以，但請把 repo 狀態、branch、測試指令、失敗輸出和禁止改動的範圍寫清楚。下一個 agent 不應該從完整對話裡猜。
前後對照
| 原始 AI 對話 | bug report 寫法 |
|---|---|
| 「可能是快取，也可能是 DB 欄位不存在。」 | 可能原因：DB schema drift；信心中，因為錯誤訊息指向 missing column。 |
| 「我跑了 lint 沒問題，但 build 爆在 /zh-TW/blog。」 | 證據：lint pass；build fail at /zh-TW/blog。 |
| 「先不要動 renderer。」 | 邊界：不要修改 renderer，先查資料欄位與 migration。 |
台灣工作場景
工程交接時，bug report 應該進 GitHub issue 或 Jira，而不是只貼一段 AI coding session 到 Slack。聊天工具可以通知 reviewer；issue 本體要留下重現步驟、環境、已試過的方向和下一個可執行任務，讓其他人不用重讀整段對話。
Highlight Reel 適合放在哪裡
Highlight Reel 可以保存 coding session 的有用片段，再把 issue 連到整理後的 AI 對話。GitHub issue 或 Jira 裡仍要有完整任務資訊，不要只貼連結。
常見問題
要把整段 coding assistant transcript 貼到 issue 嗎？
不要。保留選出的證據和片段即可。
另一個 AI agent 可以用這份 bug report 嗎？
可以，前提是重現步驟、檔案、測試和限制寫清楚。
task list 要放在哪？
放在 bug report 或 Jira/GitHub issue 本體，AI 對話連結只補背景。