mcpField
D
debug

debug

github.com/cyrusagents开发879834 次安装1 天前更新
代码仓库

关于 debug

面向开发者的调试技能,按复现问题、分析根因到实施针对性修复的流程组织工作。它强调最小改动,并通过再次复现和相关检查验证修复。

主要功能

  1. 01分析症状和错误信息
  2. 02沿代码库追踪错误
  3. 03复现并记录故障
  4. 04实施精简的针对性修复
  5. 05重做复现并运行相关测试

适用场景

  1. 01调查已报告的软件缺陷
  2. 02定位错误路径的源头
  3. 03通过最小复现确认修复
  4. 04判断是否需要回归测试

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/cyrusagents/cyrus --skill debug

安装后在 Claude Code 中输入/debug确认已加载。

详细介绍

调试

使用结构化的「复现后修复」方法调试已报告的问题。

阶段 1:复现与根因分析

  1. 调查 — 分析错误报告中的关键症状和错误消息
  2. 追踪 — 在代码库中搜索错误出现的模式,从症状追踪到源头
  3. 根因 — 通过数据流分析和边界情况检查确定根因
  4. 复现 — 用最精简且有效的检查(命令、试运行、手动流程或自动化测试)复现确切的错误
  5. 记录 — 清楚记录根因和复现步骤

阶段 2:修复实施

  1. 规划 — 根据根因分析最优修复方案,并检查代码库中是否有类似修复
  2. 实施 — 进行最小范围、有针对性的修复,以解决根因
  3. 验证 — 重复复现步骤以确认修复有效,并运行相关的现有检查。根据实际范围遵循 verify-and-ship;仅在具体故障确实需要长期覆盖时才添加回归测试

原则

  • 最小改动 — 只修复错误,不做其他改动
  • 有针对性 — 仅修改受影响的代码路径
  • 经过验证 — 确认修复后复现成功,并保留相关的现有保障;不强制要求新增测试文件
  • 不做无关改进 — 专注于特定错误

评论

支持 Markdown