关于 debug
面向开发者的调试技能,按复现问题、分析根因到实施针对性修复的流程组织工作。它强调最小改动,并通过再次复现和相关检查验证修复。
主要功能
- 01分析症状和错误信息
- 02沿代码库追踪错误
- 03复现并记录故障
- 04实施精简的针对性修复
- 05重做复现并运行相关测试
适用场景
- 01调查已报告的软件缺陷
- 02定位错误路径的源头
- 03通过最小复现确认修复
- 04判断是否需要回归测试
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cyrusagents/ cyrus --skill debug安装后在 Claude Code 中输入/debug确认已加载。
详细介绍
调试
使用结构化的「复现后修复」方法调试已报告的问题。
阶段 1:复现与根因分析
- 调查 — 分析错误报告中的关键症状和错误消息
- 追踪 — 在代码库中搜索错误出现的模式,从症状追踪到源头
- 根因 — 通过数据流分析和边界情况检查确定根因
- 复现 — 用最精简且有效的检查(命令、试运行、手动流程或自动化测试)复现确切的错误
- 记录 — 清楚记录根因和复现步骤
阶段 2:修复实施
- 规划 — 根据根因分析最优修复方案,并检查代码库中是否有类似修复
- 实施 — 进行最小范围、有针对性的修复,以解决根因
- 验证 — 重复复现步骤以确认修复有效,并运行相关的现有检查。根据实际范围遵循
verify-and-ship;仅在具体故障确实需要长期覆盖时才添加回归测试
原则
- 最小改动 — 只修复错误,不做其他改动
- 有针对性 — 仅修改受影响的代码路径
- 经过验证 — 确认修复后复现成功,并保留相关的现有保障;不强制要求新增测试文件
- 不做无关改进 — 专注于特定错误
评论
支持 Markdown