Claude Code 调试工作流：从报错到修复，AI 辅助 debug 的正确姿势

# 完整的调试提示格式
[症状]：[具体错误信息或异常行为]
[触发条件]：[什么情况下发生]
[位置]：[相关文件或模块]
[期望状态]：[正常情况下应该怎样]

# 示例
症状：用户登录后刷新页面返回 401，需要重新登录
触发条件：session token 过期后刷新触发
位置：src/auth/session.ts，特别是 refreshToken 函数
期望：token 自动刷新，用户无感知继续使用

"users report login fails after session timeout.
check auth flow in src/auth/, especially token refresh.
Write a failing test that reproduces the issue, then fix it."

# 差的
"build is failing, help me fix it"

# 好的
"build fails with this error:
[贴完整的错误堆栈]
Fix root cause. Verify build succeeds. Don't suppress the error."

# 把错误日志直接发给 Claude
cat error.log | claude

# 或者运行命令后把输出发给 Claude
npm run build 2>&1 | claude "fix these build errors"

"@src/auth/session.ts#45-80 这段 token 刷新逻辑有竞态条件：
多个请求同时触发刷新时，只有一个能成功。
分析并修复并发问题。"

"用户报告：提交空表单时不显示错误提示。
在表单提交流程里找出为什么验证不生效：
- 先检查 @src/components/LoginForm.tsx 的提交处理
- 再检查 @src/utils/validation.ts 的验证逻辑
- 如果需要，进一步追踪调用链"

"API /api/users/list 在数据量超过 1000 条时响应超过 5 秒。
分析 @src/api/users.ts 的查询逻辑，找出性能瓶颈。
目标：响应时间降到 500ms 以内。"

"以下错误在生产环境偶发，本地难以复现：
[错误信息]

根据调用栈分析根因：
1. 看 src/queue/ 是否有竞态条件
2. 检查是否有资源没有正确释放
3. 分析是否是异步处理的时序问题

不要只修症状，要找到根因并添加相应的防御性代码。"

"use a subagent to investigate all places where user session state
is read or written, and identify any inconsistencies."

Esc+Esc  # 打开 rewind 菜单
# 选「只恢复代码」，保留对话历史

修复完成后：
1. 运行失败测试，确认它现在通过
2. 运行整个测试套件，确认没有引入新问题
3. 如果是 UI bug，截图验证视觉效果
4. 提交前运行 typecheck 和 lint

# 编译/构建错误
"[贴完整错误]. Fix root cause, verify [build command] succeeds. Don't suppress."

# 运行时异常
"[症状] at [位置]. Write test reproducing the bug, then fix."

# 性能问题
"[操作] takes [时间], should be under [目标]. Profile @[文件], fix bottleneck."

# 视觉 bug
"[粘贴截图] [描述差异]. Fix and screenshot to verify."