Zc Debugging And Error Recovery

调试与恢复

zmice 69b10fe 1.7 KB Updated

File contents

调试与恢复

这是 command:start 判型后进入的专项 skill:当任务核心是定位问题、复现异常、确认根因时,进入这里,而不是继续沿完整交付流程硬推。

何时使用

  • 测试失败、构建报错或运行结果与预期不一致
  • 收到 bug 报告,需要先复现再修复
  • 某个问题反复出现,但根因不清楚
  • 你已经开始“凭感觉试错”时

输入前提

  • 已保留失败证据:报错、日志、复现步骤或测试输出
  • 接受先停线,再定位,不继续叠加功能
  • 愿意先把异常收敛成可验证问题,再回到实现主线

执行步骤

  1. Stop the line:停止继续叠加功能,先保留证据
  2. Reproduce:让失败稳定复现
  3. Localize:缩小到具体层级、文件或步骤
  4. Reduce:提炼最小复现用例
  5. Fix root cause:修根因,不修症状
  6. Guard against recurrence:补回归测试或监控
  7. Verify:重新跑验证,确认已恢复

成功标准

  • 问题可稳定复现并被最小化描述
  • 修复点对应根因,而不是表面现象
  • 已有测试或验证手段防止同类问题复发
  • 修复后完整验证重新变绿

相关原则

  • 停线优先于继续堆功能
  • 先复现,再修复
  • 调试过程必须保留证据链

回到主流程

  • 根因已明确、开始正式实现修复:回到 incremental-implementation
  • 修复完成,需要确认是否真的恢复:交给 verification-before-completion
  • 如果问题暴露了需求或方案错误:回到 spec-driven-developmentplanning-and-task-breakdown
  • 当问题涉及架构性缺陷时,可转给 architect

zmice/zc-qwen-extension/tree/main/skills/zc-debugging-and-error-recovery commit 69b10fe5cc

Frequently asked questions

npx skillmds@latest add zmice/zc-debugging-and-error-recovery