SuperAPI AI 工具集

memory-management

智能体与模型

查看项目

更新于 10-16 09:14

技能介绍

用途

该技能用于指导 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 智能体记忆的开发者或使用者,尤其是希望控制热记忆体积、避免记忆膨胀、并建立归档与日志规范的工作流。

限制

资料未提供该技能的具体安装方式、依赖环境、支持的平台或与其他工具的集成细节。