跳到主要内容

系统化故障排查:systematic-debugging

这是 Superpowers 开发方法中的排查技能。它适合处理测试失败、异常行为与难以解释的故障,强调收集证据、比较正常与异常路径、形成并验证假设,避免没有原因分析就连续打补丁。

系统化故障排查工作流:复现故障,验证根因,修复与回归

本站绘制的工作流示意;用于解释使用方式,不是原项目运行截图。

适合做什么​

  1. 把故障缩小为稳定的复现步骤。
  2. 对照正常路径与近期变化,验证原因假设。
  3. 针对根因修改,并运行能够覆盖原故障的回归检查。

建议准备的输入:结合下面的示例,提供真实资料、目标范围和预期产物,让 Agent 能判断任务是否完成。

安装方法​

这里优先使用 Superpowers 官方提供的 Claude Code 插件方式。在 Claude Code 会话中执行:

/plugin install superpowers@claude-plugins-official

这会安装 Superpowers 插件及其配套技能,不是仅安装单个目录。其他宿主请按 Superpowers 安装文档 选择对应方式,安装后新建会话并确认技能可用。

环境与适用边界​

Superpowers 还包含其他开发流程技能。若采用官方插件安装,应了解它会提供整套流程,而不仅是这一项;不同宿主按仓库对应章节安装。

使用示例​

安装后可把下面的提示词交给支持该技能的 Agent;文件名、项目地址与数据需要替换成自己的。这是使用示例,不是本站执行记录。

请使用 systematic-debugging 排查用户列表偶发重复的问题。
我会提供请求日志、复现操作和相关分页代码。
先区分重复请求、响应乱序和数据合并三个假设,逐一找证据。
确认原因后再修复,并添加能覆盖原故障的回归检查。

怎样判断完成​

  • 能说明哪个证据支持根因、哪个证据排除了其他假设。
  • 修复对应已验证的原因。
  • 原始复现步骤和相关回归检查均通过。

建议先用一个范围小、结果容易复核的任务试用,检查输入、执行过程和最终产物,再决定是否纳入固定流程。

来源与延伸阅读​