name: journal-manager description: 两层知识期刊 — 索引 + 条目系统,用于在开发过程中捕获经验教训、错误和见解。
日志管理器
一个轻量级知识期刊,用于捕获开发见解、bug修复和学到的经验教训。使用两层系统:索引文件用于快速查找,单个条目文件用于详细信息。
使用方法
添加日志条目
python .agent/skills/journal-manager/scripts/journal.py add --title "修复订单API中的N+1查询问题" --tags "性能,数据库" --body "使用DataLoader批量查询。将响应时间从2秒减少到200毫秒。"
列出最近条目
python .agent/skills/journal-manager/scripts/journal.py list
搜索条目
python .agent/skills/journal-manager/scripts/journal.py search "数据库"
显示条目详情
python .agent/skills/journal-manager/scripts/journal.py show <entry-id>
文件结构
.agent/brain/journal/
├── index.json # 快速查找:id、标题、标签、日期
└── entries/
├── 2024-01-15_fixed-n1-query.md
├── 2024-01-16_auth-flow-redesign.md
└── ...
自动保存触发器
当以下情况发生时,代理可以自动触发日志记录:
- 修复bug尝试次数≥3
- 更改涉及≥5个文件
- 检测到回滚
- 找到非明显解决方案