45 lines
1.6 KiB
Markdown
45 lines
1.6 KiB
Markdown
# Agent 长期记忆目录
|
||
|
||
> 目的：避免“换 Agent / 重启会话后失忆”，把关键事实沉淀为仓库文档。
|
||
|
||
## 文件说明
|
||
|
||
- `project-context.md`：项目现状、硬约束、当前优先级。
|
||
- `decision-log.md`：关键技术决策与原因（按日期追加）。
|
||
- `open-issues.md`：未完成项、阻塞项、下一步动作。
|
||
- `regression-checklist.md`：高风险功能回归清单（通过/失败状态）。
|
||
|
||
## 使用规则（强制）
|
||
|
||
1. 每轮任务开始前：先读上述 4 个文件。
|
||
2. 每轮任务结束后：至少更新 `decision-log.md` 与 `open-issues.md`。
|
||
3. 声称“已修复/已完成”前：更新 `regression-checklist.md` 的验证结果。
|
||
4. 长期事实只认本目录，不依赖临时 Agent 会话记忆。
|
||
|
||
## 容量上限（强制）
|
||
|
||
- `project-context.md`：不超过 220 行。
|
||
- `decision-log.md`：不超过 150 条决策或 24KB。
|
||
- `open-issues.md`：不超过 120 行。
|
||
- `regression-checklist.md`：不超过 220 行。
|
||
- 本目录总大小建议不超过 180KB（不含 `archive/`）。
|
||
|
||
超过上限时，先执行“压缩+归档”再继续新任务。
|
||
|
||
## 归档规则
|
||
|
||
- 归档目录：`docs/agent-memory/archive/`
|
||
- 归档命名：
|
||
- `decision-log-YYYY-MM.md`
|
||
- `open-issues-YYYY-MM.md`
|
||
- `regression-checklist-YYYY-MM.md`
|
||
- 当前文件顶部需保留：
|
||
- 最新摘要（3~10 行）
|
||
- 最近归档文件路径（便于追溯）
|
||
|
||
## 记录格式建议
|
||
|
||
- 日期：`YYYY-MM-DD`
|
||
- 状态：`待处理 / 处理中 / 已完成 / 阻塞`
|
||
- 每条记录尽量包含：问题、动作、证据（命令或文件路径）
|