返回技能目录
人工审校软件开发

技能研究档案

systematic-debugging

来源声明

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

保留作者的英文原始描述。它表达设计意图,不代表已验证的实际效果。

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

developmentscripts

研究摘要

人工审校

Skill Atlas editorial baseline · editorial-0.1.0

强调在修改代码前定位根因的诊断流程 Skill。它要求用证据、假设和验证替代猜测式修复。

审阅范围

对所收集的 SKILL.md 及辅助文本/代码进行确定性静态分析。机器辅助候选和发现等待人工编辑复核;不评估动态行为或效果。

可观察能力

  • 把调试结构化为证据收集和假设验证。
  • 反对随机修改和过早修复。
  • 提出修复后仍要求验证。

限制与范围

  • 不能替代领域知识或缺失的可观测性。
  • 对已知的一行修复可能显得更慢。
  • 此处未记录实测成功率。

适用读者

  • 处理复杂缺陷的开发者
  • 值班工程师
  • 只修补症状的智能体

技能包含哪些内容

文件清单来自记录提交中的采集源码。路径与大小属于结构观察,不代表质量评价。

个文件
6
Markdown 文件
4
个脚本
2
个引用
3
大小
28.4 KB
结构复杂度
低

文件清单

路径类型字节
skills/systematic-debugging/condition-based-waiting-example.ts脚本4.9 KB
skills/systematic-debugging/condition-based-waiting.md引用3.4 KB
skills/systematic-debugging/defense-in-depth.md引用3.6 KB
skills/systematic-debugging/find-polluter.sh脚本1.9 KB
skills/systematic-debugging/root-cause-tracing.md引用5.2 KB
skills/systematic-debugging/SKILL.md指令9.3 KB

SKILL.md 前置元数据

{
  "name": "systematic-debugging",
  "description": "Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes"
}

对运行顺序的一种解读

此工作流根据源码材料重建表面顺序。除非明确记录受控评估,否则它属于暂定解读,而非真实运行轨迹。

  1. 01
    输入

    确认范围

    阅读触发条件,判断该 Skill 是否匹配当前任务。

  2. 02
    操作

    加载指令

    选中 Skill 后,Claude Code 读取完整 SKILL.md。

  3. 03
    判断

    按需使用资源

    仅在文档流程需要时读取参考资料或运行脚本。

  4. 04
    输出

    交付并验证

    产出请求的交付物,并按来源描述的验收标准进行验证。

潜在风险面

静态发现用于提示安装前需要检查的位置,不能证明一项技能安全、恶意或有效。

有需要复核的项目

收集的文本中有 52 项确定性词法发现需要复核。发现可能仅位于文档中,不证明已执行或可被利用;仅含二进制的文件未扫描。

网络访问未观察到
文件写入已观察到
凭据使用未观察到
提示

文本描述或实现了文件修改

52 次命中

此行包含可能的文件写入或重定向操作。应检查目标路径和覆盖行为;静态审查没有写入任何文件。 该规则在收集文本中命中 52 处;此处列出 3 个代表位置。命中文本可能只是文档,分析器没有执行它。

编辑安全提示

在授予广泛文件系统或网络权限前,应检查诊断脚本。

上下文可能消耗在哪里

发现、激活与资源层具有不同含义。只有使用指定官方方法并记录模型的运行时,才显示精确数值。

精确 token 计数不可用

在管线使用明确模型执行官方精确计数之前,包括文件清单在内的所有 token 值均为 null。

未使用要求的官方方法记录 token 测量。本档案不会用字符数、文件大小或估计值替代。

受控评估

没有受控评估

该技能仅具备以上标明的证据。不声称任何任务成功率、token 效率、延迟或质量优势。

尚未测试

在源码可见的情况下使用

安装命令
git clone https://github.com/obra/superpowers.git cd superpowers # 将该 Skill 目录复制到以下任一位置: # ~/.claude/skills/systematic-debugging # .claude/skills/systematic-debugging
  1. 打开固定版本源码:https://github.com/obra/superpowers/tree/22f0b463e7a5e579904dd6211a520321035526f7/skills/systematic-debugging/SKILL.md。
  2. 审阅许可证、前置条件和所有捆绑资源。
  3. 将 Skill 安装到个人或项目级 Claude Code skills 目录。
  4. 重启或刷新 Claude Code,使该 Skill 可被发现。
验证安装

确认目标位置能够发现 SKILL.md,然后让 Claude Code 在测试任务中使用该 Skill。

前置条件

  • 不能替代领域知识或缺失的可观测性。
  • 对已知的一行修复可能显得更慢。
  • 此处未记录实测成功率。

示例提示词

代表性任务

Use the systematic-debugging skill to help with this task. First summarize what the skill will do, then execute its documented workflow and show the source-linked evidence for each major decision.

使用前检查

Read the systematic-debugging skill files at https://github.com/obra/superpowers/tree/22f0b463e7a5e579904dd6211a520321035526f7/skills/systematic-debugging/SKILL.md. Explain its workflow, required tools, permissions and the main risks before I decide whether to install it.

附上限制条件的判断

优势

  • 对疑难缺陷有很强的过程约束。
  • 把诊断与修复分开。

注意事项

  • 对明显故障有额外开销。
  • 依赖可用日志和复现步骤。
研究结论

适合作为疑难缺陷的推理框架,不能替代测试或可观测性。

从结构上保持可追溯

档案是对公开工件的限时阅读,而非背书。请通过来源链接检查确切的上游材料。

obrasuperpowersskills/systematic-debugging
来源类型
社区
提交
22f0b463e7a5e579904dd6211a520321035526f7
采集时间
2026年11月20日
最近核查
2026年11月20日
上游许可证
MIT
仓库星标
322,183
内容依据

仅对提供的文件进行确定性词法解析、YAML frontmatter 校验、文件清单、来源描述的工作流程提取和启发式暂定分类。由机器生成;无 LLM、执行、动态测试或人工编辑批准。