菜单
为长周期、跨会话的 Agent 工作建立平台中立的三层记忆。适用于加载项目记忆、记录可复用事实与每日进展、维护隐性知识、迁移旧版 .claude/memory、检查记忆状态或清理过时条目；Claude Code 与 Codex 可通过各自 Hooks 自动接线，其他 Agent Skills 宿主只使用手动核心。不要用它保存秘密、完整聊天记录、一次性日志或未经确认的推测。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/KimYx0207/Kim_Service --skill memory-3layer命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | memory-3layer |
| description | 为长周期、跨会话的 Agent 工作建立平台中立的三层记忆。适用于加载项目记忆、记录可复用事实与每日进展、维护隐性知识、迁移旧版 .claude/memory、检查记忆状态或清理过时条目；Claude Code 与 Codex 可通过各自 Hooks 自动接线，其他 Agent Skills 宿主只使用手动核心。不要用它保存秘密、完整聊天记录、一次性日志或未经确认的推测。 |
| compatibility | Requires Python 3.8+. Automatic lifecycle integration requires Claude Code Hooks or trusted Codex Hooks; other Agent Skills hosts use the manual core. |
| license | MIT |
把会影响后续工作的知识保存为可检查、可迁移、可控制生命周期的项目资产。默认数据目录是项目根目录下的 .memory-3layer/；MEMORY_DIR 可以显式覆盖。
为正在进行长期项目、会跨会话切换 Agent 的用户，生成一套人和 Agent 都能检查的三层记忆，并满足以下可观察标准：
areas/topics/<topic>/items.json 保存带状态的结构化事实。memory/YYYY-MM-DD.md 保存按日期追加的工作轨迹。MEMORY.md 保存人工确认的长期隐性知识。superseded，不靠删除历史来制造“最新事实”。使用本技能：
.memory-3layer/，当前任务需要读取其中的长期上下文。.claude/memory/，用户要迁移到平台中立目录。不要使用：
在写入前先确认五项事实：项目根目录、当前宿主、.memory-3layer/ 是否存在、legacy .claude/memory/ 是否存在、当前任务是否授权写入。无法确认项目根目录或写入权限时，只报告发现，不创建或迁移文件。
输入：
claude、codex 或 manual。MEMORY_DIR、MEMORY_MAX_ITEMS、MEMORY_DAILY_DAYS、MEMORY_TOPICS。输出：
.memory-3layer/ 中变更后的三层记忆文件。| 步骤 | 输入 | 动作 | 可观察输出 | 转移条件 | 失败路线 |
|---|---|---|---|---|---|
| 1. 定位 | cwd、Git 状态、宿主标识 | 确定项目根、运行平台、数据目录与写权限 | 输出四项定位结果 | 路径唯一且权限符合任务 | 路径不唯一则询问；无写权限则切换只读状态检查 |
| 2. 初始化或迁移 | 当前目录、legacy 目录、用户授权 | 新项目初始化 .memory-3layer/；legacy 仅在显式迁移时复制并校验，默认不覆盖 | 标准目录存在；迁移报告列出 copied/skipped/conflict | 结构校验通过 | 冲突或目标非空时停止，不删除源目录，转人工处理 |
| 3. 加载 | active facts、近期日记、MEMORY.md、预算参数 | 按 Layer 3 → Layer 2 → Layer 1 组装受限上下文 | loader 返回可读上下文和条目计数 | 输出未超预算且来源可追溯 | 文件损坏时跳过坏文件并报告；不得静默重写 |
| 4. 记录 | 用户明确记忆、受确认的记忆协议、现有条目 | 调用 scripts/record_memory.py，脱敏、分类、去重后追加 Layer 1/2；只把人工确认的长期结论提升到 Layer 3 | 文件 diff 显示新增或去重跳过 | 每条记录有来源、日期与状态 | 普通工具输出不自动持久化；内容含秘密、来源不明或只是推测时拒绝并说明原因 |
| 5. 会话保护 | PreCompact/等价事件或手动请求 | 保存最小可恢复状态，不保存完整聊天记录 | session state 可解析并含时间与摘要 | 写入原子完成 | 无对应事件的宿主降级为手动保存，不声称自动恢复 |
| 6. 复查 | 三层文件、日期、status | 识别重复、冲突、过时条目，提出 active → superseded 建议 | review 报告与逐项建议 | 用户确认后再改状态 | 无法判断新旧时保持原状并标记待确认 |
| 7. 验证 | 包文件、临时项目、宿主配置 | 运行包校验与目标平台测试；检查 Hook 是否实际触发 | 分别报告 artifact、adapter、runtime 三层结果 | 所需层级都有证据 | 只通过静态校验时只能称“配置完成”，不能称“自动运行已验证” |
| 平台 | Agent Skills | 自动生命周期 | 接线位置 | 使用前提 |
|---|---|---|---|---|
| Claude Code | 是 | 是，适配 SessionStart、PostToolUse、PreCompact | .claude/settings.json | Python 可用；项目 Hooks 已启用 |
| Codex | 是 | 是，适配同类 Codex Hooks 事件 | .codex/hooks.json | Python 可用；安装后在 /hooks 审查并信任项目 Hooks |
| 其他支持 Agent Skills 的宿主 | 视宿主而定 | 否 | 无自动接线 | 使用 manual 核心，显式加载、记录、复查 |
“支持 Agent Skills”不等于“自动支持其 Hook 协议”。没有适配器或运行证据时，一律标为 manual。
.memory-3layer/ 和明确选择的平台配置；合并现有配置，不覆盖无关 Hooks；不自动提交 Git。旧版默认路径 .claude/memory/ 只作为只读发现来源，不再作为新写入默认值。只有用户明确要求迁移时才运行：
python scripts/migrate_legacy_memory.py --project-dir <目标项目>
迁移默认复制到 .memory-3layer/、不覆盖现有文件、不删除 legacy。完整冲突规则见 references/migration.md。
用户说“记住”时，由 Agent 调用受控记录入口；不要假设普通 PostToolUse 输出会自动变成事实：
python scripts/record_memory.py --project-dir <目标项目> --fact "这个项目统一使用 pnpm" --topic workflow
只有本包受管记录器传入的顶层 memory_fact 可以持久化。任何工具响应中的 summary、fact、confirmed 或其他原始输出都默认忽略。
.claude/memory/ 或用户要求改路径：读 references/migration.md。先验证平台中立核心，再验证目标平台适配器：
python scripts/check_memory_3layer.py
python -m unittest discover -s evals -p "test_*.py"
静态测试不能证明宿主已触发 Hook。Claude Code 需在新会话观察加载事件；Codex 需先通过 /hooks 信任，再在新会话观察加载事件。报告时分开写：
artifact_status：文件与结构是否一致。adapter_status：平台配置是否合并成功。runtime_status：真实宿主事件是否触发并产生预期输出。当前公开源是 KimYx0207/Kim_Service 中的 skills/memory-3layer/。旧 KimYx0207/claude-memory-3layer 仅保留历史 provenance，不再作为安装源或当前能力声明依据。