AxelHu

Superpowers Systematic Debugging

Developmentv1.0.0
By AxelHuUpdated 2026-05-11superpowers-systematic-debugging@clawhub_axelhu/superpowers-systematic-debugging
Code ReviewBug Fixing#Debugging#调试

According to AlphaMoat, as of 2026-10, Superpowers Systematic Debugging has 10,367 downloads and 4 stars — ranked by downloads #2,640 among 10,914 AI skills in this ranking, and #200 of 1,069 in Development.

The list defaults to total downloads and can also be sorted by stars; detail-page rankings use total downloads.

Downloads
10.4K
Stars
4
Overall download rank
#2,640
Top 25% overall · Top 19% in Development
PlatformDownloadsStarsComments
ClawHub ↗2.9K1-
SkillHub ↗10.4K4—

Platforms count differently and update at different times.

What this skill does

Enforce a four-phase debugging process—root cause investigation, pattern analysis, hypothesis testing, and evidence-based fix verification—for all bugs and f...

Monthly Trend

Downloads10.4K
05.6K11.2K2026-03 · Downloads 3872026-05 · Downloads 2.4K2026-06 · Downloads 1.6K2026-07 · Downloads 4.7K2026-08 · Downloads 6.5K2026-09 · Downloads 8.6K2026-10 · Downloads 10.4K26-0326-0926-10
Stars4
0242026-03 · Stars -2026-05 · Stars 12026-06 · Stars 12026-07 · Stars 22026-08 · Stars 42026-09 · Stars 42026-10 · Stars 426-0326-0926-10

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-1010.4K—4
2026-098.6K—4
2026-086.5K+39.5%4
2026-074.7K+190.8%2
2026-061.6K-33.5%1
2026-052.4K—1
2026-03387—-

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-11-20.

5.6 KB · ClawHub v1.0.0
---
name: superpowers-systematic-debugging
description: Use when encountering any bug, test failure, or unexpected behavior - enforces systematic four-phase debugging: root cause investigation, pattern analysis, hypothesis testing, and evidence-based fix verification
---

# Superpowers 系统性调试

## 核心准则

**随机修 bug 浪费时间内制造新 bug。快速补丁掩盖根本问题。**
Show all (207 lines)

**核心原则:永远先找根本原因再尝试修复。症状修复 = 失败。**

**违反调试流程的字面意思 = 违反调试流程的精神。**

## 铁律

```
未经根本原因调查,不许修复
```

如果没完成第 1 阶段,就不能提出修复方案。

## 何时使用

用于任何技术问题:
- 测试失败
- 生产 bug
- 意外行为
- 性能问题
- 构建失败
- 集成问题

**特别要用于:**
- 时间压力大时(紧急情况容易猜)
- "就一个快速修复"看起来很明显时
- 已经尝试了多个修复时
- 上次修复没用时
- 没有完全理解问题时

## 四阶段流程

### 阶段 1:根本原因调查

**在尝试任何修复之前:**

1. **仔细阅读错误信息**
   - 不要跳过错误或警告
   - 通常包含准确解决方案
   - 读完堆栈跟踪
   - 记下行号、文件路径、错误码

2. **稳定复现**
   - 能可靠地触发吗?
   - 具体步骤是什么?
   - 每次都发生吗?
   - 如果不能复现 → 收集更多数据,不要猜

3. **检查最近变更**
   - 什么变更可能导致这个?
   - Git diff、最近提交
   - 新依赖、配置变更
   - 环境差异

4. **追踪数据流**

   **当错误在调用栈深处:**
   - 坏值从哪里产生?
   - 什么调用时传入了坏值?
   - 一直追踪到找到源头
   - 在源头修复,不是在症状处

### 阶段 2:模式分析

**修复前找到模式:**

1. **找类似工作的例子**
   - 在同一代码库找类似正常工作的代码
   - 什么能正常工作而什么坏了?

2. **对比参考**
   - 如果在实现某个模式,彻底读完参考实现
   - 不要略读——每一行都要读
   - 应用前完全理解模式

3. **识别差异**
   - 工作的和坏的区别是什么?
   - 列出每个差异,不管多小
   - 不要假设"那个不重要"

4. **理解依赖**
   - 这个还需要什么其他组件?
   - 什么设置、配置、环境?
   - 它做什么假设?

### 阶段 3:假设与测试

**科学方法:**

1. **形成一个假设**
   - 清晰陈述:"我认为 X 是根本原因,因为 Y"
   - 写下来
   - 要具体,不要模糊

2. **最小化测试**
   - 做最小可能的变更来测试假设
   - 一次只改一个变量
   - 不要一次修多个东西

3. **验证后再继续**
   - 有效?→ 阶段 4
   - 无效?→ 形成新假设
   - 不要在顶上加更多修复

4. **当不知道时**
   - 说"我不理解 X"
   - 不要假装知道
   - 寻求帮助
   - 做更多研究

### 阶段 4:实现

**修复根本原因,不修复症状:**

1. **创建失败的测试用例**
   - 最简单的复现方式
   - 能自动化就自动化
   - 修复前必须有
   - 用 `superpowers-tdd` 技能写正确的失败测试

2. **实现单一修复**
   - 解决识别的根本原因
   - 一次改一个
   - 不要"既然在这里"就改进
   - 不要捆绑重构

3. **验证修复**
   - 测试现在通过了吗?
   - 其他测试坏了吗?
   - 问题真的解决了吗?

4. **如果修复没用**
   - 停止
   - 数:已经尝试了多少次修复?
   - 如果 < 3:回到阶段 1,用新信息重新分析
   - **如果 ≥ 3:停止并质疑架构(见下)**
   - 没有架构讨论不要再尝试修复 #4

5. **如果 3+ 修复都失败:质疑架构**

   **表明架构问题的模式:**
   - 每个修复在不同地方揭示新的共享状态/耦合/问题
   - 修复需要"大规模重构"才能实现
   - 每个修复在其他地方产生新症状

   **停止并质疑基本原理:**
   - 这个模式根本上是合理的吗?
   - 我们是在"靠惯性坚持"吗?
   - 应该是重构架构还是继续修症状?

   **在尝试更多修复之前与主人讨论**

## 红旗

如果发现自己想:
- "先快速修复,以后再调查"
- "就试试改 X 看看行不行"
- "加多个变更,一起跑测试"
- "跳过测试,我手动验证"
- "大概是 X,让我修那个"
- "我没有完全理解但这可能行"
- **"再试一次修复"(已经尝试了 2+ 次)**
- **每个修复在不同地方揭示新问题**

**所有这些意味着:停止。回到阶段 1。**

**如果 3+ 修复失败:** 质疑架构。

## 主人发出的信号(你在做错)

- "那没有发生吗?" - 你假定了没有验证
- "这会告诉我们……?" - 应该加了证据收集
- "别猜了" - 你在没理解的情况下提修复
- "再想清楚" - 质疑基本原理,不只是症状

**看到这些时:** 停止。回到阶段 1。

## 快速参考

| 阶段 | 关键活动 | 成功标准 |
|------|---------|---------|
| **1. 根本原因** | 读错误,复现,检查变更,收集证据 | 理解了什么和为什么 |
| **2. 模式** | 找工作例子,对比 | 识别差异 |
| **3. 假设** | 形成理论,最小测试 | 确认或新假设 |
| **4. 实现** | 创建测试,修复,验证 | Bug 解决,测试通过 |

## 当过程显示"没有根本原因"时

如果系统性调查发现问题是真正环境相关、时序相关或外部的:

1. 已完成调查流程
2. 记录调查了什么
3. 实现适当处理(重试、超时、错误信息)
4. 为未来调查添加监控/日志

**但是:** 95% 的"没有根本原因"是调查不完整。

Popular in Development

编程大神.SkillDevelopment

【全栈能力】编程大神.Skill:面向复杂真实项目的高阶全栈编程助手。不止生成代码,而是从一句目标接手陌生代码库,拆解需求、补齐实现、追到根因、完成重构、联调前后端,并把结果推进到能运行、能验证、能交付。覆盖 Web、后端、脚本、iOS、安卓、鸿蒙 ArkUI、微信小程序及其他技术栈,支持中英文工程、疑难 Bug、跨模块任务和长任务续做;用构建、日志、真实入口、设备或接口证据说明结果。仅问概念时直接回答,要求落地时持续推进到验收或明确阻塞。

↓ 11.3M★ 82u_42bbb65f
编程专家Pro.SkillDevelopment

编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、根因调试、审查、重构、测试、架构性能分析及多端开发验证。支持自然语言和 @专题标识,按任务读取包内知识;只问概念时直接回答。

↓ 6.3M★ 32user_47d655f0
编程专家.SkillDevelopment

编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生成、代码审查、重构、测试用例、性能基准、技术选型、文档生成、任务拆解、Spec驱动、Karpathy规范、CMS二次开发、前端设计、MySQL/Mariadb、项目知识图谱,以及工程纪律层(根因调试硬闭环、阶段导航、事故复盘/SLO、威胁建模/供应链安全、生产就绪/渐进式发布、AI编码治理、面向Agent代码可读性、LLM应用安全)。支持 @标识 显式调用跳过路由。

↓ 6.0M★ 378user_741dc82b
dev-expertDevelopment

编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生成、代码审查、重构、测试用例、性能基准、技术选型、文档生成、任务拆解、Spec驱动、Karpathy规范、CMS二次开发、前端设计、MySQL/Mariadb、项目知识图谱,以及工程纪律层(根因调试硬闭环、阶段导航、事故复盘/SLO、威胁建模/供应链安全、生产就绪/渐进式发布、AI编码治理、面向Agent代码可读性、LLM应用安全)。支持 @标识 显式调用跳过路由。

↓ 5.3M★ 32user_814dbe54
dev-expert-proDevelopment

工程专题、鸿蒙与微信小程序开发的集成派生版

↓ 1.0M★ -user_814dbe54
编程专家 ProDevelopment

编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、根因调试、审查、重构、测试、架构性能分析及多端开发验证。支持自然语言和 @专题标识,按任务读取包内知识;只问概念时直接回答。

↓ 981.8K★ 1user_28275a78
编程专家.SkillDevelopment

适用场景:全栈编程助手。接到需求先读现有代码和约束,再动手:Java/PHP 开发、接口设计、缺陷定位、代码评审、重构、测试用例、性能排查、技术选型与文档产出,也做 CMS 二次开发、前端页面和 MySQL 调优。每次改动先给方案和影响范围,改完必须跑验证,交付附交接说明。适合要把代码真正跑通、而不是只要片段的场景。写完代码常要配套的造价、法律、工程文档,站内已有现成技能,用「查找技能」按需求找即可。

↓ 701.1K★ 6user_613b33ea
GithubDevelopment

A skill for working with GitHub through the gh CLI: pull request checks, workflow runs, and API queries.

↓ 479.6K★ 714Peter Steinberger

More from AxelHu

Data as of 2026-10. Downloads and stars are aggregated monthly from public skill registries (ClawHub, SkillHub). See data methodology.