用途：把会影响后续工作的知识保存为可检查、可迁移、可控制生命周期的项目资产，供跨会话、跨 Agent 的长期项目使用。默认数据目录为项目根目录下的 .memory-3layer/，可用 MEMORY_DIR 覆盖。
主要能力：三层结构——Layer 1 在 areas/topics/<topic>/items.json 保存带状态的结构化事实；Layer 2 在 memory/YYYY-MM-DD.md 按日期追加工作轨迹；Layer 3 在 MEMORY.md 保存人工确认的长期隐性知识。新会话只加载受预算约束的 active 内容；旧知识可标记为 superseded，不删除历史。
使用方式：写入前先确认项目根目录、当前宿主、.memory-3layer/ 与 legacy .claude/memory/ 是否存在、是否授权写入。显式记录用 python scripts/record_memory.py --project-dir <目标项目> --fact "..." --topic <主题>；迁移用 python scripts/migrate_legacy_memory.py --project-dir <目标项目>，默认复制、不覆盖、不删除源目录。验证用 python scripts/check_memory_3layer.py 与 python -m unittest discover -s evals -p "test_*.py"。
平台接线：Claude Code 通过 .claude/settings.json 适配 SessionStart、PostToolUse、PreCompact；Codex 通过 .codex/hooks.json，安装后需在 /hooks 审查并信任。其他支持 Agent Skills 的宿主不自动接线，降级为 manual 显式加载、记录、复查。
适用场景：加载项目记忆、记录可复用事实与每日进展、维护隐性知识、迁移旧版记忆、检查记忆状态或清理过时条目。
限制：不替代 Git、数据库、备份或宿主原生记忆，不保存完整聊天历史；秘密、令牌、私钥、支付信息、未脱敏个人数据不得写入；模型推断须标注，不能直接升级为长期事实；路径歧义、格式损坏、迁移冲突或校验失败时停止写入；静态校验只能称“配置完成”，不能称“自动运行已验证”。