核心功能
crash-fixer 是一个自主式崩溃分析与自动修复技能,专为现代云原生应用设计。它通过连接 Cloudflare Worker D1 崩溃上报端点,实现从故障发现到代码修复的全自动化流程。
工作机制
1. 数据采集:定期从 /crashes 端点拉取崩溃报告,支持按时间窗口(默认24小时)筛选,排除用户反馈类噪音数据
2. 智能分析:提取错误名称和堆栈关键词,结合 GPT-4o 深度推理根因,定位具体代码位置
3. 自动修复:通过 GitHub API 搜索相关文件,生成最小化代码变更,自动创建分支、提交和 Pull Request
显著优势
- 响应速度:从崩溃发生到 PR 生成可在分钟级完成,远快于人工排查
- 上下文感知:结合堆栈追踪和代码库搜索,修复建议精准定位
- 可控执行:
--dry-run模式支持安全预览,--limit参数防止批量误操作 - 无缝集成:原生支持 OpenClaw 定时任务,可配置 Telegram 通知形成闭环
局限性与风险
| 维度 | 说明 |
|------|------|
| **AI幻觉风险** | GPT-4o 可能对复杂异步问题产生错误归因,导致"修复"引入新 bug |
| **权限安全** | 需 `GH_TOKEN` 具备写权限,泄露将导致代码库被篡改 |
| **泛化能力** | 对 `CANNOT_FIX` 类通用错误(如网络波动)无法自动生成修复 |
| **评审缺失** | 自动化流程绕过人工 code review,高风险变更可能直接就绪 |
适用场景
- 高频迭代的 SaaS 产品,需要 24/7 稳定性保障
- 堆栈信息完整、错误模式明确的 NullPointer/TypeError 类问题
- 具备完善测试覆盖的代码库,可快速验证 AI 生成补丁
安全建议
建议配合强制 CI 检查、PR 模板审批流程,避免将 --dry-run 长期关闭。对于涉及支付、身份验证等敏感模块的崩溃,应强制人工复核。