代码报错排查
把可复现的故障、报错原文和技术栈交过去,按七步协议定位根因、给出最小修复并补一条回归测试。
功能与用途
遇到报错最容易犯的错是直接改代码碰运气,改了半天不知道到底哪一步生效了。这套方法把排错拆成固定七步:先让它稳定复现,再靠注释、二分和 git bisect 收窄范围,然后提出一个能被验证的根因假设并加日志或断点去证伪,确认后才做最小修复,最后补一条能抓住这个 bug 的回归测试。针对 JS/TS、Python、Swift、CSS、网络这几类问题还各给了具体的调试命令和常见错误对照表。
适用场景
- 报错只在特定输入下出现,手动试了几次都复现不了,需要先把复现:报错只在特定输入下出现,手动试了几次都复现不了,需要先把复现条件固定下来
- 项目最近几个提交之后才出问题,但不知道是哪一个,想在提交历史:项目最近几个提交之后才出问题,但不知道是哪一个,想在提交历史里二分定位到具体那次改动
- Console 里只有一句 undefined 属性读取失败:Console 里只有一句 undefined 属性读取失败,堆栈指向框架内部,看不出是自己的哪段数据有问题
- 修完之后担心同类问题再犯,想补一条测试把这次的场景固定住:修完之后担心同类问题再犯,想补一条测试把这次的场景固定住
适用人群
- 日常写业务代码的前后端开发工程师
- 需要定位线上偶发故障的运维与SRE
- 带新人排查 bug 的技术负责人
使用步骤
- 先把复现条件写清楚:确切步骤、输入、运行环境和完整报错原文,让它先帮你把问题稳定复现
- 按它的建议收窄范围,可以用注释、二分查找,或者用 git bisect 在提交历史里定位到可疑改动
- 让它提出一个有具体预测的根因假设,然后在代码里加定向日志、断点或断言去验证
- 确认根因后只接受最小修复,先别顺手重构,避免把新问题引进来
- 让它补一条能抓住这个 bug 的回归测试,跑通后再合并
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- 1.0.0
- 最近更新
- 2026-07-04
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Provides a systematic 7-step debugging protocol with language-specific commands and quick diagnostic tools for JavaScript, Python, Swift, CSS, network, and git.
使用前准备
- 需要本机能运行对应语言与调试工具(node、pdb、lldb、curl、dig 等),git bisect 需要完整的提交历史
依赖与权限
- PORT
- 读取用户主动提供的内容