KoonChaoSo Agent Error Logger
记录 Agent 犯过的错误，避免重复踩坑。
功能
- 自动记录: 任务失败时自动记录错误详情
- 模式识别: 识别重复出现的错误模式
- 主动提醒: 新任务前检索相似错误，提前预警
- 统计分析: 按月/类型统计错误分布
文件结构
workspace/memory/
├── error-patterns.md # 错误模式索引（长期）
└── error-log-YYYY-MM.md # 月度详细日志
使用方式
1. 记录错误
用户：记录一个错误，刚才发布小红书失败了
Agent: 好的，请告诉我：
1. 任务是什么？
2. 具体错误是什么？
3. 原因是什么？
4. 怎么修正的？
或者我帮你从对话中提取这些信息？
2. 查询错误
用户：查一下之前发布失败的错误
用户：有没有类似的文件校验错误？
用户：显示所有 #网络超时 的错误
3. 主动提醒
Agent: 等一下，我查一下错误日志...
上次发布小红书失败是因为图片文件不存在。
这次请确认：
✓ 图片文件路径是否正确
✓ 如果是 URL，需要先下载
✓ 文件权限是否可读
错误记录格式
### 错误 #XXX - 简短描述
- **时间**: YYYY-MM-DD HH:MM
- **任务**: 任务描述
- **错误**: 具体错误信息
- **原因**: 根本原因分析
- **修正**: 修正方案
- **模式标签**: #标签 1 #标签 2
- **相似错误**: 关联的错误编号
模式标签
| 标签 | 描述 | 检查清单 |
|---|---|---|
| #文件校验 | 文件/路径未校验 | 文件存在、路径正确、权限足够 |
| #网络超时 | 网络请求超时 | 设置 timeout、重试机制、降级方案 |
| #浏览器不可用 | 浏览器工具失败 | 替代方案、合理超时、降级逻辑 |
| #权限不足 | API/文件权限问题 | 检查授权、权限范围 |
| #参数缺失 | 必需参数未提供 | 参数清单、默认值、用户确认 |
脚本工具
record-error.sh
记录新错误：
cd /path/to/agent-error-logger/scripts
python record_error.py \
--task "发布内容失败" \
--error "图片文件不存在" \
--cause "用户只提供了 URL，未下载" \
--fix "发布前先下载 URL 图片" \
--tags "#文件校验 #图片处理"
search-errors.sh
查询错误：
python search_errors.py --tag "#文件校验" --limit 5
python search_errors.py --keyword "关键词" --limit 10
monthly-report.sh
生成月度报告：
python monthly_report.py --month YYYY-MM --output markdown
主动检查清单
在以下场景自动检索错误日志：
| 场景 | 检查内容 |
|---|---|
| 发布内容前 | 检查 #文件校验 #发布前检查 |
| 网络请求前 | 检查 #网络超时 #降级方案 |
| 浏览器操作前 | 检查 #浏览器不可用 |
| 复杂任务前 | 检查相似任务的错误历史 |
最佳实践
- 及时记录: 错误发生后立即记录，细节更准确
- 详细分析: 不仅记录现象，还要分析根本原因
- 标签规范: 使用统一标签，便于检索
- 定期回顾: 每月回顾错误模式，更新检查清单
- 主动提醒: 新任务前主动检索，避免重复错误
扩展建议
- 自动从对话中提取错误信息
- 错误相似度计算（向量检索）
- 错误趋势分析（图表）
- 集成到 HEARTBEAT 自检
- 多 Agent 共享错误库