메뉴
为长周期、跨会话的 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에서 현재 제공할 수 있는 파일을 다운로드하세요.
Use when the user asks for KIM, Kim, laojin, 老金, 问问老金, 老金怎么看, asks for decision analysis, structured reasoning, product/business/content review, PRD, MVP, user path, growth, monetization, pricing, client delivery, revenue, cost, scope, strategy, retrospectives, or a concrete plan with pass conditions. Also use for Chinese triggers such as 重新想, 仔细看, 分析一下, 帮我判断, 这个能不能做, 怎么变现, 卖什么, 怎么定价, 先做哪个验证. Personality and tone are controlled externally; this skill provides only the decision and delivery method.
当用户要写出高质量 Goal Prompt 和交付后继续进化用的 Loop Prompt，把模糊、战略性、多步骤、证据不足、持续/自动化或容易跑偏的请求整理成可执行、可验证、可暂停且带时间参数的目标契约时使用。适用于写 goal、优化任务提示词、明确 done/success criteria、deep research 后定战略、大改前 inventory、修复跑偏计划、识别可委托的重复 workflow、为 Codex 或 Claude Code 准备执行任务；默认只生成提示词，不执行 goal 或 loop，也不创建自动化。
Cross-runtime Agent Teams orchestration playbook for Claude Code, Codex, OpenClaw, and Cursor. This skill should be used when the user asks to "create agent teams", "use agent swarm", "setup multi-agent collaboration", "orchestrate agents", "coordinate parallel agents", "organize team collaboration", "build agent teams", "implement swarm orchestration", "setup multi-agent system", "coordinate agent collaboration", or needs guidance on adaptive team formation, quality gates, skill discovery, task distribution, team coordination strategies, or Agent Teams best practices. 或者当用户说"多agent"、"agent协作"、"agent编排"、"并行agent"、"分工协作"、"拉团队"、"拉个团队"、"多代理协作"、"swarm编排"、"agent团队"时也应使用此技能。Note: "swarm/蜂群" is a generic industry term; Claude Code's official concept is "Agent Teams"; Codex, OpenClaw, and Cursor should map this playbook to their native or host-provided agent capabilities without deleting any workflow stage.
SOC 직업 분류 기준
SKILL.md 표시 중
| 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，不再作为安装源或当前能力声明依据。