Agent 错误日志工具。记录、检索和分析 Agent 犯过的错误，避免重复踩坑。 支持自动记录任务失败、手动查询错误模式、生成修正建议。
记录 Agent 犯过的错误，避免重复踩坑。
workspace/memory/
├── error-patterns.md # 错误模式索引（长期）
└── error-log-YYYY-MM.md # 月度详细日志
用户：记录一个错误，刚才发布小红书失败了
Agent: 好的，请告诉我：
1. 任务是什么？
2. 具体错误是什么？
3. 原因是什么？
4. 怎么修正的？
或者我帮你从对话中提取这些信息？
用户：查一下之前发布失败的错误
用户：有没有类似的文件校验错误？
用户：显示所有 #网络超时 的错误
Agent: 等一下，我查一下错误日志...
上次发布小红书失败是因为图片文件不存在。
这次请确认：
✓ 图片文件路径是否正确
✓ 如果是 URL，需要先下载
✓ 文件权限是否可读
### 错误 #XXX - 简短描述
- **时间**: YYYY-MM-DD HH:MM
- **任务**: 任务描述
- **错误**: 具体错误信息
- **原因**: 根本原因分析
- **修正**: 修正方案
- **模式标签**: #标签 1 #标签 2
- **相似错误**: 关联的错误编号
| 标签 | 描述 | 检查清单 |
|---|---|---|
| #文件校验 | 文件/路径未校验 | 文件存在、路径正确、权限足够 |
| #网络超时 | 网络请求超时 | 设置 timeout、重试机制、降级方案 |
| #浏览器不可用 | 浏览器工具失败 | 替代方案、合理超时、降级逻辑 |
| #权限不足 | API/文件权限问题 | 检查授权、权限范围 |
| #参数缺失 | 必需参数未提供 | 参数清单、默认值、用户确认 |
记录新错误：
cd /path/to/agent-error-logger/scripts
python record_error.py \
--task "发布内容失败" \
--error "图片文件不存在" \
--cause "用户只提供了 URL，未下载" \
--fix "发布前先下载 URL 图片" \
--tags "#文件校验 #图片处理"
查询错误：
python search_errors.py --tag "#文件校验" --limit 5
python search_errors.py --keyword "关键词" --limit 10
生成月度报告：
python monthly_report.py --month YYYY-MM --output markdown
在以下场景自动检索错误日志：
| 场景 | 检查内容 |
|---|---|
| 发布内容前 | 检查 #文件校验 #发布前检查 |
| 网络请求前 | 检查 #网络超时 #降级方案 |
| 浏览器操作前 | 检查 #浏览器不可用 |
| 复杂任务前 | 检查相似任务的错误历史 |
ZIP package — ready to use