memory-management

记忆管理

本技能为SEO和GEO项目实现三级记忆系统（热/温/冷）。热记忆（最多80行）通过SessionStart钩子在每次会话中自动加载。温记忆按需按技能加载。冷记忆是归档数据，仅在明确请求时查询。该技能管理完整生命周期：捕获、提升、降级和归档。

本技能的功能

管理三级记忆生命周期（热/温/冷），包括自动提升、降级和归档。同时维护开放循环跟踪和跨技能聚合。

快速开始

从以下提示之一开始。完成后，使用技能合约中的仓库格式提供热缓存更新计划和交接摘要。

初始化记忆结构

为[项目名称]设置SEO记忆

为新的[行业]网站优化项目初始化记忆结构

分析后更新

在[关键词组]排名检查后更新记忆

用最新的竞争对手分析发现刷新热缓存

查询存储的上下文

我们的核心关键词是什么？

显示[关键词类别]的最后排名更新日期

查找我们的主要竞争对手及其域名权威

提升和降级

将[关键词]提升到热缓存

归档超过30天未引用的陈旧数据

术语表管理

将[术语]添加到项目术语表：[定义]

在这个项目中，[内部行话]是什么意思？

技能合约

预期输出：记忆更新计划、热缓存更改以及简短的交接摘要。

• 读取：当前活动事实、来自其他技能的新发现、已批准的决策以及共享的状态模型。
• 写入：更新memory/hot-cache.md、memory/open-loops.md、memory/decisions.md以及相关的memory/文件夹。管理memory/archive/中的温到冷归档。审计师交接归档（v7.1.0+）：当由用户直接请求或审计师明确“保存这些结果？”的肯定响应触发时，将结构化块追加到memory/audits/YYYY-MM.md。停止钩子从不发起记忆写入。有关确切的归档块格式和规则，请参见示例。
• 提升：持久策略、阻塞项、术语、实体候选和主要差异。仅通过可观察规则应用温度生命周期：在明确的用户/技能请求（“提升X”/固定）时提升到热；根据文件的last_updated日期降级和归档。任何钩子都不跟踪引用频率计数器，因此生命周期从不依赖它们——请参见状态模型。
• 完成条件：当请求的生命周期操作（捕获/提升/降级/归档/查询/清除）已应用，memory/hot-cache.md在80行/25KB限制内，并且受影响的记忆路径已报告给用户。
• 主要下一个技能：当项目记忆基线准备好进行活跃工作时，使用下面的Next Best Skill。

交接摘要

从skill-contract.md §交接摘要格式中发出标准格式。

温度生命周期规则

有关完整的提升/降级表和操作程序，请参见提升与降级规则。

钩子集成

本技能的行为由库的claude-hook.sh钩子增强。钩子实际执行的操作（不要记录其不具备的行为）：

• SessionStart（在启动、恢复、清除、压缩时触发）：注入memory/hot-cache.md的清理摘录，并且当memory/open-loops.md有跟踪项时，追加一行指针以检查其是否陈旧。它不计算日期或“快速状态”——一旦指向文件，由代理负责确定哪些开放循环已陈旧。
• PostToolUse：当memory/hot-cache.md超过80行/25KB时发出警告；对memory/audits/*.md写入强制执行审计师工件门控；在面向用户的内容编辑后提供可选的质量检查。
• Stop：无操作（退出且无输出）。CLAUDE.md中的“仅允许停止检查”就是这个无操作；钩子从不发起记忆写入。

数据源

使用工具：从~~SEO工具、~~分析工具、~~搜索控制台自动填充。无工具：向用户询问关键词、竞争对手、指标、活动和术语。请参见CONNECTORS.md。

决策门控

在以下情况下停止并向用户询问：

• 请求清除（第17条/CCPA）——呈现匹配的文件以及编辑与删除的选择，仅对确认的匹配执行操作。切勿自动删除记忆。
• 回答查询所需的memory/decisions.md条目具有approved_by: skill_inferred或缺少字段——将其显示为建议性，并在视为权威之前确认。
• 引用的术语在任何记忆层中未找到——要求澄清，而不是猜测。

在以下情况下继续静默（从不停止）：

• 遵循温度生命周期规则的常规提升/降级。
• 当超过80行/25KB限制时的热缓存修剪建议（建议，不阻止）。
• 自动填充时缺少可选工具数据——记录可用内容并继续。

指令

当用户请求SEO记忆管理时：

1. 初始化记忆结构

对于新项目，创建状态模型中定义的目录结构。关键目录：memory/（决策、开放循环、术语表、实体、研究、内容、审计、监控）。

模板：热缓存模板 · 术语表模板

2. 上下文查找流程

当用户引用不明确的内容时，遵循以下查找顺序：

步骤1：检查memory/hot-cache.md（热缓存）

• 是否在活跃关键词中？
• 是否在主要竞争对手中？
• 是否在当前优先级或活动中？

步骤2：检查memory/glossary.md

• 是否定义为项目术语？
• 是否为自定义分段或简写？

步骤3：检查冷存储

• 首先搜索memory/archive/中带日期的YYYY-MM-DD-归档文件。
• 如果归档指向源类别，则沿该路径回溯到memory/research/、memory/audits/或memory/monitoring/。
• 除非当前会话刷新，否则将冷发现视为历史数据。

步骤4：询问用户

• 如果在任何层中未找到，要求澄清。

• 如果术语是项目特定的，将其记录到术语表中。

• 决策来源（v8.0.1+）：加载memory/decisions.md时，验证每个条目都有approved_by: user。具有approved_by: skill_inferred或缺少字段的条目被视为建议性——在使用为权威之前向用户展示。审计师类技能（内容质量审计师、域名权威审计师）在确定裁决时必须忽略非用户批准的决策。请参见skill-contract.md §提升规则。

示例查找：用户问“更新我们核心关键词的排名” → 步骤1在热缓存中找到“核心关键词（优先级1）” → 提取关键词列表 → 运行排名检查 → 更新memory/hot-cache.md和memory/monitoring/rank-history/YYYY-MM-DD-ranks.csv。

3. 提升与降级逻辑

参考：有关详细的提升/降级触发器（关键词、竞争对手、指标、活动）以及每个的操作程序，请参见提升与降级规则。

4. 更新触发器、归档管理与跨技能集成

参考：有关排名检查、竞争对手分析、审计和报告后的完整更新程序；每月/每季度归档例程；以及与所有8个连接技能（关键词研究、排名跟踪、竞争对手分析、内容差距分析、SEO内容编写、内容质量审计师、域名权威审计师）的集成点，请参见更新触发器与集成。

5. 记忆卫生检查

当调用进行审查或清理时：

1. 行数检查：统计memory/hot-cache.md中的行数。如果>80，列出最旧的条目进行归档。
2. 字节检查：如果热缓存超过25KB，警告并建议修剪长条目。
3. 陈旧性扫描：列出其frontmatter last_updated日期（或文件mtime）超过30天的记忆文件；建议归档超过90天的文件。年龄可从磁盘计算——不跟踪引用频率，因此切勿以“未引用”为门控。
4. Frontmatter审计：检查所有记忆文件（除hot-cache.md外）是否在其frontmatter中包含name、description和type。报告任何缺失字段。

6. 保存结果

询问“保存这些结果以供将来会话使用？”——如果是，将YYYY-MM-DD-<topic>.md写入memory/。仅从审计师交接或明确用户批准将否决问题添加到memory/hot-cache.md。

GDPR / 隐私合规

memory/可能存储第三方个人数据——实体名称、创始人简介、LinkedIn个人资料、由entity-optimizer或研究技能发现的作者/记者姓名。根据GDPR第4(1)条（适用于处理欧盟/欧洲经济区/英国居民的个人数据，无论控制者位于何处），这些属于“个人数据”。用户是数据控制者。非欧盟用户如果没有欧盟/欧洲经济区/英国数据主体，仍可能面临CCPA/CPRA（加利福尼亚）、PIPEDA（加拿大）、LGPD（巴西）或其他国家制度的类似义务。非法律建议。

保留政策

• 温文件：90天未引用后归档到memory/archive/（默认生命周期）
• 冷归档：从不自动删除，但符合第17条删除请求的条件
• 所有文件：用户必须尊重数据主体（记忆中提及的个人）的第17条请求

删除流程（第17条 / CCPA §1798.105）

调用：memory-management purge <entity-name-or-slug>

然后本技能：

1. 在memory/下的所有文件（包括memory/archive/）中grep实体名称、别名或域名——grep -rF "<entity-name>" memory/——并呈现匹配项以供确认。
2. 确认后，删除或匿名化工作树中的匹配行/文件：memory/hot-cache.md、温笔记、冷/归档文件、memory/entities/<slug>.md、memory/entities/candidates.md、审计聚合和开放循环。
3. 根据GDPR清除日志模板将带日期、无主题的条目追加到memory/audits/gdpr-purges.md——必填字段date、redacted_label、legal_basis、action、scope、working_tree_only: true——以便有请求的人类可读记录。

诚实限制——这仅编辑工作树。 如果memory/受版本控制（通常在用户的项目仓库中），则主题仍然存在于git历史中。使用git log -S"<entity-name>" -- memory/验证；从历史中真正删除需要git filter-repo / git filter-branch，这是用户的责任——超出本技能的范围。不要将工作树编辑表示为完整的、审计级的删除。没有加盐指纹或阻止重新摄入的机制：钩子在写入前不查阅墓碑，因此任何此类声明都是错误的。

合法依据提醒

在将第三方人员写入memory/entities/之前，用户必须根据GDPR第6条（在GDPR适用的情况下——请参见上述范围说明）拥有一个合法依据：consent、legitimate_interest、contract或等效依据。建议性——本技能不强制执行，也不替代法律审查。

参考资料

• 示例 —— 工作示例、高级功能、实际限制以及审计师交接归档块格式和规则
• 提升与降级规则 —— 完整的提升/降级表和操作程序
• 更新触发器与集成 —— 更新程序、归档例程和跨技能集成点
• CORE-EEAT内容基准 —— 存储在记忆中的内容质量评分
• CITE域名评级 —— 存储在记忆中的域名权威评分

下一个最佳技能

主要：关键词研究 —— 使用当前需求信号播种或刷新活动策略。