用途:在遇到失败时提供结构化恢复流程,核心原则是评估、保留证据、恢复、验证、记录,避免慌乱操作。
主要能力:按严重程度分级(Critical、Major、Minor、Info)并评估范围与影响;在修复前保留错误日志、堆栈、Git 状态、环境变量、依赖列表和截图等证据;针对代码错误、构建错误、环境问题、外部服务故障提供不同恢复路径,如 git checkout、git reset、git stash、清理并重装依赖、重试外部服务;恢复后验证工作区干净、测试通过、构建成功、类型检查通过;最后通过 issue 评论或知识图谱记录过程。
使用方式:技能启动时声明“I'm using error-recovery to handle this failure.”,然后依次执行五步协议。常用命令包括 pnpm test 2>&1 | tee error-log.txt、git status、git diff、pnpm list、git checkout HEAD -- path/to/file.ts、git reset --soft [GOOD_COMMIT]、git reset --hard [GOOD_COMMIT]、git stash、rm -rf node_modules dist build .cache、pnpm install --frozen-lockfile、pnpm build、pnpm typecheck、curl -I https://service.example.com/health 等。若恢复尝试 2-3 次仍失败,则升级为不可恢复错误,标记为 Blocked 并等待人工介入。
适用场景:代码或功能损坏、构建失败、环境异常、外部服务不可用、测试由通过转为失败、本地正常但 CI 失败等。
限制:资料未提供具体平台、收费、价格或效果保证;部分命令依赖 pnpm、git、nvm 等工具环境,需按实际项目调整;外部服务故障只能等待或重试,无法直接修复。