AI Skill 大全

代码报错排查

把可复现的故障、报错原文和技术栈交过去,按七步协议定位根因、给出最小修复并补一条回归测试。

功能与用途

遇到报错最容易犯的错是直接改代码碰运气,改了半天不知道到底哪一步生效了。这套方法把排错拆成固定七步:先让它稳定复现,再靠注释、二分和 git bisect 收窄范围,然后提出一个能被验证的根因假设并加日志或断点去证伪,确认后才做最小修复,最后补一条能抓住这个 bug 的回归测试。针对 JS/TS、Python、Swift、CSS、网络这几类问题还各给了具体的调试命令和常见错误对照表。

适用场景

  • 报错只在特定输入下出现,手动试了几次都复现不了,需要先把复现:报错只在特定输入下出现,手动试了几次都复现不了,需要先把复现条件固定下来
  • 项目最近几个提交之后才出问题,但不知道是哪一个,想在提交历史:项目最近几个提交之后才出问题,但不知道是哪一个,想在提交历史里二分定位到具体那次改动
  • Console 里只有一句 undefined 属性读取失败:Console 里只有一句 undefined 属性读取失败,堆栈指向框架内部,看不出是自己的哪段数据有问题
  • 修完之后担心同类问题再犯,想补一条测试把这次的场景固定住:修完之后担心同类问题再犯,想补一条测试把这次的场景固定住

适用人群

  • 日常写业务代码的前后端开发工程师
  • 需要定位线上偶发故障的运维与SRE
  • 带新人排查 bug 的技术负责人

使用步骤

  1. 先把复现条件写清楚:确切步骤、输入、运行环境和完整报错原文,让它先帮你把问题稳定复现
  2. 按它的建议收窄范围,可以用注释、二分查找,或者用 git bisect 在提交历史里定位到可疑改动
  3. 让它提出一个有具体预测的根因假设,然后在代码里加定向日志、断点或断言去验证
  4. 确认根因后只接受最小修复,先别顺手重构,避免把新问题引进来
  5. 让它补一条能抓住这个 bug 的回归测试,跑通后再合并

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
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
  • 读取用户主动提供的内容

同类 Skill