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