memory-management

name	memory-management
description	在 Claude 会话之间持久化 SEO/GEO 营销活动的上下文，包括自动的热门列表、正在进行的工作以及归档层级。项目记忆/跨会话功能。
version	9.9.5
license	Apache-2.0
compatibility	Claude Code, skills.sh, ClawHub, Vercel Labs, Cursor, Windsurf, Codex CLI, Amp, Gemini CLI, Kimi Code, Qwen Code, CodeBuddy
homepage	https://github.com/aaron-he-zhu/seo-geo-claude-skills
when_to_use	Use when reviewing, archiving, or cleaning up campaign memory. Also when the user asks to check saved findings, manage hot cache, or archive old data.
argument-hint	[review|archive|cleanup]
metadata	{"author":"aaron-he-zhu","version":"9.9.5","geo-relevance":"low","tags":["seo","geo","project-memory","context-management","campaign-tracking","session-context","hot-cache","项目记忆","プロジェクト記憶","프로젝트메모리","memoria-proyecto"],"triggers":["remember project context","save SEO data","refresh wiki index","build wiki index","remember this for next time","what did we decide last time","what do we know so far","project status","wiki lint","项目记忆管理","跨会话记忆","刷新wiki索引","保存进度","上次说了什么","プロジェクト記憶","wikiインデックス更新","프로젝트 메모리","세션 기억","memoria del proyecto","guardar progreso","memória do projeto","gerenciar memória"]}

内存管理

本技能为SEO和GEO项目实现了三级内存管理系统（HOT/WARM/COLD）。HOT内存（最多80行）通过SessionStart钩子在每次会话时自动加载；WARM内存根据需求按技能进行加载；COLD内存则存储被归档的数据，仅在明确请求时才会被查询。该技能负责管理数据的整个生命周期，包括捕获、提升、降级和归档等操作。

功能概述

• 管理三级内存（HOT/WARM/COLD），并自动执行数据的提升、降级和归档操作。
• 维护wiki索引层、开环跟踪功能以及跨技能的数据整合。

快速入门

• 从以下提示之一开始操作。完成后，需使用Skill Contract中的仓库格式，编写一份热缓存更新计划和交接总结。

初始化Wiki索引

Refresh wiki index

Build wiki index for [project name]

从现有的WARM文件生成memory/wiki/index.md。此操作仅需执行一次，之后索引会自动更新。

初始化内存结构

Set up SEO memory for [project name]

Initialize memory structure for a new [industry] website optimization project

分析后的更新

Update memory after ranking check for [keyword group]

Refresh hot cache with latest competitor analysis findings

查询存储的内容

What are our hero keywords?

Show me the last ranking update date for [keyword category]

Look up our primary competitors and their domain authority

数据的提升与降级

Promote [keyword] to hot cache

Archive stale data that hasn't been referenced in 30+ days

术语管理

Add [term] to project glossary: [definition]

What does [internal jargon] mean in this project?

Skill Contract（技能契约）

预期输出：包括内存更新计划、热缓存变更内容以及简短的交接总结。

• 读取数据：当前的活动信息、来自其他技能的新发现、已批准的决策结果，以及共享的状态模型。
• 写入数据：更新memory/hot-cache.md、memory/open-loops.md、memory/decisions.md及相关memory/文件夹的内容；负责将WARM级数据归档到memory/archive/。同时编译memory/wiki/index.md（自动更新）和用户确认后的wiki页面。wiki的唯一写入者：memory-management拥有所有wiki内容的写入权限。为提升性能，memory/wiki/index.md的自动更新功能被委托给hooks/hooks.json中的PostToolUse钩子。wiki日志更新和编译后的页面仍由memory-management负责处理。
• 审计交接与归档（v7.1.0及以上版本）：当用户直接请求或审计人员明确表示“保存这些结果”时，会将相关内容追加到memory/audits/YYYY-MM.md文件中。Stop钩子不会触发任何数据写入操作。归档文件会被/seo:run-evals工具和维护人员用于审核，以符合ADR-001中的要求。具体归档格式和规则请参见references/examples.md。
• 数据提升规则：根据使用频率将数据提升至HOT级别；数据过时则降级至WARM级别。
• 下一步交接：当项目内存基础数据准备好进行进一步处理时，使用[Next Best Skill]进行交接。

交接总结

请按照skill-contract.md §Handoff Summary Format中的格式编写交接总结。

数据生命周期规则

详细规则和操作流程请参见references/promotion-demotion-rules.md。

钩子集成

本技能的行为通过库中的钩子来实现：

• SessionStart：加载memory/hot-cache.md，检查是否存在过时的开环数据；如果存在memory/wiki/<project>/index.md（或全局index.md），则将其加载；根据next_action项的状态提供用户指导。
• PostToolUse：在任何WARM文件写入后，自动更新memory/wiki/index.md；提示用户更新编译后的页面。
• Stop：仅允许完成操作；返回{"ok": true}，尊重stop_hook_active设置，不会要求用户保存可选的发现结果，也不会触发任何数据写入操作。

数据来源

• 使用工具时：数据会自动从SEO工具、分析系统或搜索控制台获取；
• 未使用工具时：需用户提供关键词、竞争对手信息、指标数据、活动详情和术语。具体细节请参见CONNECTORS.md。

使用说明

当用户请求SEO内存管理时，请按照以下步骤操作：

1. 初始化内存结构

• 对于新项目，创建状态模型中定义的目录结构。关键目录包括：memory/（决策记录、开环数据、术语表、实体信息、研究资料、内容文件、审计记录、监控数据）以及memory/wiki/（自动管理的编译索引，可包含项目特定的子目录）。
• 模板：hot-cache-template.md、glossary-template.md、Wiki design archive。

Wiki层

memory-management负责wiki的架构设计。通过钩子委托的索引更新仅会修改memory/wiki/index.md和memory/wiki/<project>/index.md。wiki日志的更新仍由memory-management负责处理。索引行包含精确的字段（如score、status、next_action、mtime），编译后的页面需要包含type、project、sources[].path、sources[].hash和last_compiled等字段。

2. 数据查找流程

当用户需要查询信息时，按照以下步骤进行：

• 步骤1：检查memory/hot-cache.md（热缓存）
  • 该信息是否在活跃的关键词列表中？
  • 是否包含在主要竞争对手的信息中？
  • 是否属于当前的活动或项目范围？
• 步骤2：检查Wiki索引（memory/wiki/index.md或项目级索引），查找相关的WARM文件。
• 步骤3：检查memory/glossary.md
  • 该术语是否被定义为项目专用术语？
  • 是否为自定义内容或缩写形式？
• 步骤4：检查COLD存储
  • 首先在memory/archive/中查找带有日期戳的归档文件（格式为YYYY-MM-DD-）。
  • 如果归档文件指向特定来源，继续在memory/research/、memory/audits/或memory/monitoring/中查找相关内容。
• 步骤5：如果未找到相关信息，询问用户详细信息；
  • 如果是新术语，将其添加到术语表中（仅限项目专用）。
• 决策来源验证（v8.0.1及以上版本）：在加载memory/decisions.md时，验证每个条目的approved_by字段是否为“user”。如果字段为approved_by: skill_inferred或缺失，则该条目被视为“建议性信息”，在使用前需用户确认。审计类技能（如content-quality-auditor、domain-authority-auditor）在做出判断时必须忽略未经用户批准的决策。具体规则请参见skill-contract.md §Promotion Rules。

示例：用户请求“更新我们的关键词排名”，系统会首先在热缓存中查找“Hero Keywords (Priority 1)”，然后提取关键词列表，执行排名检查，并更新memory/hot-cache.md和memory/monitoring/rank-history/YYYY-MM-DD-ranks.csv文件。

数据的提升与降级逻辑

详细规则和触发条件请参见references/promotion-demotion-rules.md。

更新触发机制、归档管理及跨技能集成

更新流程、归档规则以及与其他技能的集成方式请参见references/update-triggers-integration.md。

内存维护检查

• 行数检查：统计memory/hot-cache.md的行数；如果超过80行，建议将最旧的条目归档。
• 大小检查：如果热缓存文件超过25KB，会发出警告并建议删除冗长内容。
• 过时检查：列出30天内未被引用的文件，并建议将超过90天的文件归档。
• 前缀检查：确保所有内存文件（memory/hot-cache.md除外）的前缀部分包含name、description和type字段；报告任何缺失的字段。

结果保存

用户可以选择“保存这些结果以供后续会话使用”，系统会将结果保存为YYYY-MM-DD-<topic>.md文件到memory/目录中；自动保存的文件会保存到memory/hot-cache.md中。

示例、高级功能及实际限制

• 详细示例和高级功能请参见[references/examples.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/cross-cutting/memory-management/references/examples.md），包括关键词排名、术语表查询、电子商务项目初始化等示例，以及实际使用中的限制（如并发访问、冷存储数据检索、数据更新频率、wiki编译等）。

GDPR/隐私合规性

memory/目录可能会存储第三方个人数据（如实体名称、创始人简介、LinkedIn个人资料等）。根据GDPR第4(1)条（适用于欧盟/欧洲经济区/英国居民的个人数据处理），这些数据属于“个人数据”。用户是数据控制者。非欧盟用户虽然不受GDPR约束，但仍需遵守CCPA/CPRA（加拿大）、LPD（巴西）等地区的相应法规。

• 数据保留政策：
  • WARM级文件在90天内未被引用后会被自动归档到memory/archive/。
  • COLD级文件永远不会被自动删除，但可根据用户请求进行删除（符合GDPR第17条）。
• 所有文件均需遵守数据主体的删除请求（如GDPR第17条或CCPA §1798.105条）。

删除流程（GDPR第17条）

调用memory-management purge <entity-name-or-slug>命令时，系统会：

• 在memory/目录（包括memory/archive/）中查找包含指定实体名称或标识符的文件，
• 提示用户确认删除操作，
• 从memory/entities/<slug>.md、memory/entities/candidates.md中删除相关条目，并在其他文件中标记删除痕迹，
• 将删除操作记录在memory/audits/gdpr-purges.md文件中（包含日期和删除对象信息）。

法律依据

在将第三方信息写入memory/entities/目录之前，用户必须具备GDPR第6条规定的合法依据（如用户同意、合法利益等）。请注意：本技能不负责执行法律审核。

参考资料

• references/examples.md：包含实际使用示例、高级功能、限制信息以及归档格式和规则。
• references/promotion-demotion-rules.md：包含数据提升/降级的完整规则和操作流程。
• references/update-triggers-integration.md：包含更新流程、归档规则及与其他技能的集成方式。
• CORE-EEAT Content Benchmark：用于评估内容质量的评分数据。
• CITE Domain Rating：用于评估网站权威性的评分数据。

下一个推荐技能

下一个推荐技能是keyword-research，它可以根据当前需求信号帮助更新关键词排名策略。