# Zc Debugging And Error Recovery

> 调试与恢复

- Skill: `zmice/zc-debugging-and-error-recovery` (Agent Skill)
- Install (CLI): `npx skillmds@latest add zmice/zc-debugging-and-error-recovery`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zmice/zc-debugging-and-error-recovery/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: zmice (https://skillmd.com/u/zmice)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zmice/zc-debugging-and-error-recovery

---


# 调试与恢复

这是 `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-development` 或 `planning-and-task-breakdown`
- 当问题涉及架构性缺陷时，可转给 `architect`