系统化调试与错误恢复
用结构化流程定位根因，修复错误并防止复发。
技能明确要求保留证据、将错误输出视为不可信数据，并提醒移除敏感日志；但 npm install、git bisect、运行开发服务、加告警等外部或环境变更没有用户确认、权限边界或回滚说明，数据流和生产事故处理范围也不完整，因此扣分。
六步流程和异常分支较一致，包含不可复现、测试、构建和运行时错误的诊断路径；但命令假设 npm、Node 和特定测试参数，未覆盖不同项目工具链，也没有提交级、针对该技能关键路径的可执行复现证据，因此按静态评估限制扣分。
触发场景清晰，覆盖测试、构建、运行时和生产问题，且提供非可复现分支；但范围将“任何意外”表述得较宽，缺少明确非适用边界、输入输出定义、非 JavaScript 环境适配和中文使用说明，因此扣分。
结构清楚，包含概览、触发条件、步骤、模式、红旗和验证清单；仓库 README 提供安装方式，且有 MIT 许可证、团队信息和 CI；但该技能没有独立版本、变更记录、维护责任或更新路径，也缺少 FAQ、依赖说明和工具链替代方案，因此扣分。
流程可直接指导根因定位、回归测试和端到端验证，具有明显的人工调试增益；但示例和命令较通用，未证明在代表性项目中输出可直接使用，且可能需要按项目测试框架、包管理器和环境调整，因此静态上限内扣分。
技能内容本身可审阅，仓库 CI 验证技能格式、评估运行器和安装结构；但提供的测试夹具与该技能无关，未见覆盖其调试关键路径的专门测试或第三方执行证据，因此只能给有限分数。
- 运行 npm install、git bisect、开发服务或生产告警前，应明确目标范围、用户确认、权限和回滚方案。
- npm/test/build 命令可能不适用于非 npm 或非 JavaScript 项目；应先确认项目工具链并避免机械执行示例参数。
- 日志和错误上下文可能包含凭据、个人数据或业务数据；技能只提出移除敏感日志，未提供系统化脱敏和访问控制流程。
- 未提供该技能关键路径的专门执行测试，静态审查不能证明流程在目标环境中稳定有效。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 AI 编程代理的通用调试工作流技能，适用于测试失败、构建中断、运行时错误和生产事故。它要求代理停止继续开发，先保留错误证据，再依次执行复现、定位、缩减、根因修复、回归防护和端到端验证。技能还提供测试、构建和运行时错误的分类排查模式，以及安全降级和日志埋点建议。它适合希望减少猜测式修复、建立可验证调试过程的工程团队。
要求代理收集错误输出、日志、环境信息和复现步骤；运行特定测试、详细测试、隔离测试、完整测试和构建命令；按 UI、API、数据库、构建工具、外部服务或测试本身定位故障层级；必要时使用 git bisect 查找引入回归的提交；创建最小失败案例；修复根因并添加回归测试；最后验证原始场景、测试套件和构建结果。
- 前端或后端开发者在代码改动后遇到测试失败，需要判断是测试过时还是代码出错。
- 工程师发现构建报类型、导入、配置、依赖或环境错误，需要按错误类别定位原因。
- 维护者遇到无法稳定复现的运行时问题，需要区分时序、环境、状态或随机因素。
- 生产支持人员收到日志中的异常或 bug 报告，需要保留证据、缩小范围并验证修复。
- 团队修复缺陷后，希望通过回归测试和端到端检查降低再次发生的风险。
这个 Skill 有哪些优点和局限？
- 流程明确，要求按顺序复现、定位、缩减、修复、加防护并验证。
- 覆盖测试失败、构建错误、运行时错误和不可复现问题。
- 强调回归测试、证据保留和端到端验证。
- 包含安全降级、日志埋点和不信任错误输出的实用规则。
- 提供材料未显示该技能有独立测试套件或专属平台集成。
- 命令示例依赖 Node.js/npm 和 Git；不同项目的测试与构建命令可能需要调整。
- 技能指导排查流程，但不自动诊断具体项目，也未提供项目专属工具配置。
如何安装这个 Skill？
安装整个仓库：npx skills add addyosmani/agent-skills。安装单个技能：npx skills add addyosmani/agent-skills --skill debugging-and-error-recovery。README 还记录了 Codex CLI v0.122+ 的仓库级安装方式：codex plugin marketplace add addyosmani/agent-skills。
如何使用这个 Skill？
在已安装该技能的兼容代理中，遇到测试失败、构建中断、行为异常或日志错误时直接提出问题，例如：“这个测试在代码改动后失败了，请按复现、定位、缩减、根因修复、回归防护和端到端验证的顺序排查。”具体的客户端调用方式未在该技能文件中单独规定。