开发测试 · 卡兹克推荐 309.8k 仓库 Star
Systematic Debugging
先找到原因,再修改代码
系统化排查问题是按步骤定位软件故障的 Skill。它先读取错误、复现现象并查看相关变更,再比较正常与异常路径,提出可检验的原因假设。确认根因后实施针对性修复,并检查原问题和相关行为,适合测试失败、功能异常及不稳定故障。
你需要准备:项目代码、报错信息、复现步骤与相关日志
一桉AI 整理 · 更新 · 查看 GitHub 来源
粘贴到 Codex,它会先检查安装条件,再引导你使用。
Systematic Debugging 能帮你做什么?
收集可复现的证据
记录错误、输入、环境和近期变更,在多层调用中确认问题最早出现的位置。
逐个验证原因假设
寻找相似的正常实现,比较差异,用尽量小的实验判断原因,避免同时修改多处而难以归因。
修复并回查原问题
围绕已经定位的原因修改代码,补充合适的复现测试,再确认原症状与相关检查结果。
什么时候适合用?
下面是用法示例,可换成你的材料和目标。
接口偶发返回错误
例如比较成功与失败请求的输入、日志和依赖状态,定位问题来自参数、服务还是调用顺序。
升级后测试失败
例如核对依赖变化与原有正常行为,先复现失败,再验证兼容性假设和修复范围。
怎么开始使用?
你提供的材料
准备这些材料系统化排查问题
项目代码、报错信息、复现步骤与相关日志
处理流程示意
- 01
复现并收集证据
- 02
验证根因假设
- 03
最小修复并复查
准备什么,会得到什么?
- 准备的材料
- 项目代码、报错信息、复现步骤与相关日志
- 交付的结果
- 包含复现方法、根因假设及验证过程的排查记录。
- 针对原因的修复建议或代码变更,以及复查结果。
使用前要知道
需要项目、日志和可运行的复现环境,并使用完整 Superpowers 插件的关联测试与验证资源。外部服务或时序问题可能只能缩小范围,不能凭经验保证立即修好。
常见问题
连续改了几次仍失败怎么办?
应停止叠加猜测性修改,重新核对复现、证据和原先假设。多次失败也可能说明对依赖关系或架构的理解需要调整。
最后发现是环境问题算定位成功吗?
如果有证据把异常关联到网络、配置、时序或外部依赖,可以记录这个结论及验证方法。无法确认时应保留未解决状态。
GitHub 与官方参考
依据项目说明与参考文档整理。页面中的任务与流程示例用于说明用法。
- systematic-debugging · SKILL.md ↗2026-10-31 核对
- Superpowers · Codex 完整插件说明 ↗2026-10-31 核对
来源与使用条件
- 原始项目
- obra/superpowers ↗
- 作者/维护者
- obra / Superpowers
- 推荐者
- 数字生命卡兹克
- 介绍出处
- 查看推荐介绍 ↗
- Skill 名称
systematic-debugging- Skill 目录
skills/systematic-debugging- 仓库 Star
- 309,781 · 2026-10-31 核对,仅代表仓库关注度。
- 许可说明
- MIT
- 使用条件
- 需要访问项目和相关日志,并能运行项目的复现、调试及验证命令;使用完整流程时还可能引用 Superpowers 的测试驱动开发与完成前验证等其他 Skill。
- 注意事项
- MIT 许可。当前上游 README 为 Codex App/CLI 提供官方插件市场安装入口,旧 .codex/INSTALL.md 已不存在。仅拷一个目录不代表具备完整 Superpowers 流程;本站未安装或运行该项。
查看安装与使用提示词
请帮我准备并使用 Systematic Debugging Skill,完成下面的任务。请实际执行当前环境允许的安装与检查,不要只返回一份安装教程。 【来源与目标】 原始仓库:https://github.com/obra/superpowers 所选目录:skills/systematic-debugging 参考分支:main 原始目录 frontmatter name:systematic-debugging 安装后的目标调用名:systematic-debugging 来源页面:https://github.com/obra/superpowers/tree/main/skills/systematic-debugging 安装路线核对日期:2026-11-01 systematic-debugging:当前源 SKILL.md:https://github.com/obra/superpowers/blob/main/skills/systematic-debugging/SKILL.md Superpowers:当前 Codex App/CLI 插件安装:https://github.com/obra/superpowers/blob/main/README.md#codex-app Superpowers:Codex 插件清单:https://github.com/obra/superpowers/blob/main/.codex-plugin/plugin.json 【先检查环境,再安装】 先识别操作系统、当前 shell、工作目录、同名 Skill 和已有工具;命令须适配实际平台并正确处理带空格的路径。默认安装到当前项目的 .agents/skills;如果没有可用项目目录,再使用用户目录的 .agents/skills。遵循当前 Codex 实际支持的位置;上游 CLI 或插件有专用目录时使用其正式方案。检查现有安装来源与完整性,能复用就复用,不重复注册相同来源、不覆盖用户修改。系统内置与所选第三方来源同名时保留系统版,明确区分来源和实际目录,不能只凭名称认定装过或选对了。 下文 ~/.agents/skills 是用户级路径示例;已选项目范围时,使用项目的 .agents/skills 并保持相同子目录层级。<SKILL_DIR>、<项目根目录> 等占位符须先换成核对过的真实路径再执行。依赖仓库的存放目录与 Codex 发现入口分别处理,不把缓存目录当作已注册入口。 这是插件安装路线。按下列官方入口安装完整插件;仅复制某个 Skill 目录不能代替插件、连接器或 MCP 配置。若当前 Codex 必须由用户在界面完成插件安装或授权,请给出准确入口和最短步骤,完成后再检查所选 Skill。 所选 Skill 的具体安装步骤: 1. 先检查 Superpowers 是否已通过 Codex 插件安装;已安装则检查来源和版本,不叠加旧手工 Skills 目录。 2. Codex App 使用侧栏 Plugins,在 Coding 中找到 Superpowers,点击 + 并完成原生安装提示。 3. Codex CLI 使用 /plugins,搜索 superpowers,然后选择 Install Plugin。当前上游将 Codex 指向官方插件市场,不再使用旧 .codex/INSTALL.md。 4. 保留整插件、using-superpowers 引导、其他被调用 Skills 与所列资源;不要把单个 SKILL.md 的下载成功当作整套流程安装完成。 5. 检查 Skill 可发现状态;未出现时再重载或新聊天,涉及插件原生配置时按宿主提示处理。 必须保留的资源: - 完整 Superpowers 插件(.codex-plugin/plugin.json、skills/ 及插件引导资源) - skills/systematic-debugging/(整目录) - skills/systematic-debugging/root-cause-tracing.md - skills/systematic-debugging/defense-in-depth.md - skills/systematic-debugging/condition-based-waiting.md - skills/systematic-debugging/find-polluter.sh 与目录中其他示例/测试资料 已知依赖:需要访问项目和相关日志,并能运行项目的复现、调试及验证命令;使用完整流程时还可能引用 Superpowers 的测试驱动开发与完成前验证等其他 Skill。 原项目许可:MIT 特别条件:MIT 许可。当前上游 README 为 Codex App/CLI 提供官方插件市场安装入口,旧 .codex/INSTALL.md 已不存在。仅拷一个目录不代表具备完整 Superpowers 流程;本站未安装或运行该项。 需要账号、密钥或服务时先检查现有可用连接;让用户在官方授权或本地配置入口完成,不要求把密钥粘贴到聊天。缺少付费服务或不支持的客户端能力时,明确剩余条件与可完成的范围。 【安装后验收】 读取实际安装位置的 SKILL.md,核对真实 name,并检查它引用的脚本、模板、共享文件与工具是否存在。若上游已迁移路径或更名,先核对正式说明再调整;找不到则报告实际错误,不猜路径或宣称成功。 1. 核对插件来源 obra/superpowers、当前所选 Skill 的 name 与源文件一致,并能通过 Skill 选择器明确选中。 2. 核对上述根因追踪与等待策略参考文件存在;读取项目测试命令与日志入口,不因安装检查执行复现、停进程或改代码。 Codex 通常自动发现变更;只有未出现时才引导新建聊天或重载。若本轮尚未出现在可用列表,可在允许的范围内读取已安装的完整文件继续准备任务,同时说明自动识别尚待确认。插件依赖的工具未连接时,不能用读取文件代替连接成功。 分别报告“文件已安装”“Codex 已识别”“任务所需能力已就绪”的实际状态和证据;失败时给出卡住的步骤、错误与下一步,不反复执行相同的失败命令。 【接着引导我使用】 请使用实际可用的 $systematic-debugging;若实际名称发生变化,以刚核对的本地 name 为准。存在不同来源同名项时,明确选择所选来源与实际文件路径,避免调用成系统版或另一版本。对于必须由用户显式调用的 Skill,直接给我下一条可复制的调用语句。 - 提供复现步骤、完整错误、最近变更和影响范围;先收集证据、追踪根因,再提出单一假设并做最小验证。 - 实际修复在用户授权项目中进行,并运行与问题相关的检查;无法复现或环境不足时明确报告,不直接猜补丁。 我想完成的任务: 排查我提供的问题。先复现并收集错误、变更和数据流证据,再提出可验证的根因假设,做最小范围修复并运行适合项目的验证。区分已确认原因与待验证猜测,保留无关功能和现有项目约束。 需要我提供的材料: 项目代码、报错信息、复现步骤与相关日志 期望得到: 一份包含复现方式、根因证据、修复说明和实际验证结果的问题处理记录。 先查看我在当前聊天中已经提供的目标与材料,只问缺少的关键内容;没有材料时,告诉我第一步提供什么,可给一个简短示例。条件满足后从一个小任务开始,检查输出,再说明怎样继续使用。示例仅用于演示,不充当我的真实数据;没有执行过的步骤、测试或交付物不要写成已经完成。需要发送、发布或修改外部账号内容时,先让我核对具体对象和内容。