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.
Install
npx skills add sandbaseai/workbuddy-skill --skill debugging-strategiesgit 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-strategiesPersonal 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`,说明根因、促成条件、残余风险和未做实验。 ## 复现记录模板
Details
- Skill name
debugging-strategies- Repository
- sandbaseai/workbuddy-skill
- 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
Access Control Security Best Practices
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/workbuddy-skill
Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.
Deprecation and Migration
9sandbaseai/workbuddy-skill
Use when replacing or sunsetting an old system, API, library, feature, or schema; plan consumer migration, compatibility windows, usage proof, and safe removal.
Debugging Methodology
9sandbaseai/workbuddy-skill
Use when investigating a software defect, intermittent failure, incorrect result, crash, or unexplained operational symptom.
Doubt Driven Development
9sandbaseai/workbuddy-skill
Use when a non-trivial decision, high-impact action, unfamiliar code change, or safety-sensitive claim needs a bounded adversarial review before it stands.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.