核心用法
memory-management 是一套面向 SEO/GEO 战役的三级记忆生命周期管理系统(HOT/WARM/COLD),专为 Claude 等 AI 编码助手的跨会话场景设计。
三级架构:
- HOT(热缓存):
memory/hot-cache.md,每会话自动加载,80行/25KB上限,存放当前优先级最高的关键词、竞品、决策 - WARM(温层):按需加载的项目文件,分布于
memory/各子目录(decisions、open-loops、glossary、entities、research 等) - COLD(冷归档):
memory/archive/,90天未引用即归档,需显式查询
关键操作:
1. 初始化:Set up SEO memory for [project] 创建目录结构与模板
2. 查询链路:Hot-Cache → Wiki Index → Glossary → Cold Storage → 询问用户
3. 数据更新:分析后执行 Update memory after ranking check,自动晋升高频引用项,降级陈旧数据
4. Wiki 层:memory/wiki/index.md 自动索引所有 WARM 文件,支持跨项目聚合
显著优点
- 跨会话连续性:通过 SessionStart/PostToolUse/Stop 三大 Hook 实现无感记忆加载与更新
- 智能温度管理:基于引用频率自动晋升(promote)/降级(demote),避免信息过载
- 审计级追溯:决策需
approved_by: user才视为权威,审计类技能自动忽略推断性决策 - GDPR 合规:内置
purge命令支持 Art 17 删除请求,自动记录审计日志 - 多语言触发:支持中英日韩葡等 12+ 语言指令,降低团队使用门槛
潜在缺点与局限
- 并发风险:文档明确警告多会话同时写入可能导致数据竞争,建议单会话独占
- 冷存储检索成本:COLD 层需显式 grep 遍历,大数据量时查询延迟显著
- 数据新鲜度依赖人工:无自动外部数据源同步,需配合
rank-tracker、competitor-analysis等技能主动刷新 - Wiki 编译非全自动:Index 自动刷新,但 compiled pages 需用户确认生成
- Hook 行为不透明:SessionStart 加载逻辑对终端用户黑盒,调试需查阅
hooks/hooks.json
适合人群
- SEO/GEO 项目经理:需长期跟踪多战役、多阶段决策的团队
- 多会话协作者:频繁中断/恢复 Claude 会话,需要上下文无缝衔接
- 合规敏感行业:处理含个人数据的实体研究(创始人、作者档案),需 GDPR/CCPA 审计能力
- 规模化运营:管理 10+ 战役、数百关键词矩阵的内容团队
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据丢失 | 并发写入或意外中断可能导致 hot-cache 损坏 | 定期手动快照 `memory snapshot` |
| 决策漂移 | 非用户批准决策(`skill_inferred`)被误用 | 审计技能自动过滤,人工复查 decisions.md |
| 隐私违规 | 存储第三方个人数据未履行删除义务 | 严格执行 `purge` 流程,维护 `gdpr-purges.md` 日志 |
| 信息过载 | HOT 层超限后旧数据自动降级,关键信息可能沉底 | 80行/25KB 监控告警,主动归档策略 |
| 工具依赖 | 部分功能需配合 keyword-research、rank-tracker 等技能 | 严格遵循 "Next Best Skill" 推荐链路 |
---
版本: 9.5.0 | 协议: Apache-2.0 | 作者: aaron-he-zhu