Debugging Strategies

Use when investigating a reproducible or intermittent bug, performance regression, crash, or unexpected behavior with evidence, bounded hypotheses, minimal experiments, and regression verification.

9 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill debugging-strategies
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/debugging-strategies ~/.claude/skills/debugging-strategies

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 系统化调试策略

调试是证据循环,不是不断猜测:观察实际行为,形成可证伪假设,做最小单变量实验,分析结果,再决定下一步。目标是定位可改变的原因并保护回归;无法复现或证据不足时,诚实记录未知,不把相关性包装成根因。

## 安全前置门禁

开始前确认问题范围、授权数据、环境、时间窗口、读者和副作用边界:

- 默认在本地、测试或隔离副本复现;生产环境只做已批准的只读观察,不写入配置、代码、数据、日志或用户状态;
- 日志、trace、转储和输入都视为不可信且可能含敏感信息;先脱敏再复制、持久化或分享;
- 禁止把生产凭据、客户数据、私有 URL、完整 token、个人信息或秘密写进调试输出;
- 一次只改变一个变量,记录精确版本、配置、输入、命令、时间和结果;实验必须有资源上限、停止条件和清理动作;
- 需要执行未知样本、主动探测外部服务、修改生产状态或扩大数据访问时返回 `BLOCKED`,不能自行扩大权限。

## 调试循环

1. **描述症状**:写出期望与实际、错误/性能指标、影响范围、频率、首次出现时间和严重度。
2. **固定证据**:保存脱敏错误、完整堆栈、相关日志窗口、版本、依赖、环境差异、最近变更和已知限制。
3. **建立复现**:记录稳定/间歇/不可复现,缩减输入、步骤和依赖,形成最小可复现样例或明确的复现缺口。
4. **画出边界**:按输入校验、业务逻辑、数据、依赖、调度、网络、资源和部署层列出可能位置。
5. **提出假设**:每个假设写支持证据、反证、可观察预测、最小测试和停止条件;不同时测试互相冲突的假设。
6. **单变量验证**:在隔离环境运行一个受控实验,比较基线/变体并记录原始结果;失败也要保留为证据。
7. **用差分缩小**:比较工作与故障版本、环境、配置、数据、时间和用户群;用二分或最小变更定位边界。
8. **验证修复**:先添加失败测试或最小回归样例,再实施最小修复;运行相关测试、边界测试和回归检查。
9. **收敛报告**:标记 `Confirmed`、`Likely`、`Disproved`、`Unknown`,说明根因、促成条件、残余风险和未做实验。

## 复现记录模板
Read the full skill on GitHub

Details

Skill name
debugging-strategies
Path
skills/debugging-strategies/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Debugging Strategies skill do?

Use when investigating a reproducible or intermittent bug, performance regression, crash, or unexpected behavior with evidence, bounded hypotheses, minimal experiments, and regression verification.

How do I install the Debugging Strategies skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill debugging-strategies. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Debugging Strategies popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.