用途
该技能用于指导 AI 智能体如何管理自身记忆,帮助判断哪些信息值得写入 MEMORY.md(热记忆),哪些应归档到 memory/archive/(冷记忆),哪些只需留在每日日志中。适用于决定写入内容、组织记忆文件结构,以及审查记忆健康状况的场景。
主要能力
Q1/Q2/Q3 判断流程
每次要记录信息时,依次问三个问题:
- Q1:下次醒来不看这条,会做错事吗?若为 Yes,写入 MEMORY.md,标记 [P0]。
- Q2:某天可能需要查这条吗?若为 Yes,写入 memory/archive/,标记 [P1]。
- Q3:以上都不是?留在 daily log,不处理。
优先级标签与 TTL
| 判断 | Priority | TTL | 位置 |
|---|---|---|---|
| Q1=Yes | [P0] | 永不过期 | MEMORY.md |
| Q2=Yes | [P1][YYYY-MM-DD] | 90天 | MEMORY.md → archive |
| Q3 | [P2][YYYY-MM-DD] | 30天 | MEMORY.md → archive |
示例
| 信息 | Q1 | Q2 | 去向 |
|---|---|---|---|
| "用户时区是 US Eastern" | ✅ | - | MEMORY.md [P0] |
| "2月8日买反了方向" | ❌ | ✅ | archive [P1] |
| "今天跑了扫描" | ❌ | ❌ | daily log |
硬性限制
- MEMORY.md ≤ 150 行,硬约束,不是建议。
- AGENTS.md ≤ 200 行,同样是硬约束。
- 超过就必须精简,没有例外。
常见误区
热记忆误区(MEMORY.md)
- 把项目细节写进热记忆,例如"项目X客户叫王总,电话138-xxxx",项目结束后这条就没用了。
- 把每日任务写进热记忆,例如"今天要写完xxx功能",属于一次性内容,不该沉淀。
- 把所有教训都塞进热记忆,例如"今天学到了xxx",不是每条都值得,应等复盘再决定。
- 把调试过程写进热记忆,例如"试了A方案不行,换B方案",这是过程而非结论。
冷记忆误区(archive)
- 归档后从来不查,归档是为了能查到,不查就没意义,解决方式是使用 memory_search 召回。
- 标题写得不清楚,例如"2026-02.md",应写成"2026-02 交易教训和决策"。
日志误区(daily log)
- 当天就删日志,日志是保命用的,出问题要回放。
- 日志写太详细(小作文),例如"今天下午2:15分,我和技术顾问讨论了...",应只记关键点,不是写日记。
自动化工具
memory-janitor.py
每日 4 AM UTC 自动运行,功能包括:
- 检查 P1/P2 条目的 TTL
- 过期条目移到 archive
- 警告无标签条目
手动运行命令:
python3 memory-janitor.py
检查状态命令:
python3 memory-janitor.py --dry-run
写入检查清单
每次写 MEMORY.md 前:
- □ 跑过 Q1/Q2/Q3 判断
- □ 打了 Priority 标签
- □ 检查当前行数(wc -l MEMORY.md)
- □ 不是项目细节/每日任务/调试过程
适用场景
适用于需要长期维护 AI 智能体记忆的开发者或使用者,尤其是希望控制热记忆体积、避免记忆膨胀、并建立归档与日志规范的工作流。
限制
资料未提供该技能的具体安装方式、依赖环境、支持的平台或与其他工具的集成细节。