菜单
项目记忆系统 - 自动读取上下文、自动沉淀发现、追踪需求与技术变更
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | memory-bank |
| description | 项目记忆系统 - 自动读取上下文、自动沉淀发现、追踪需求与技术变更 |
运行时若已注入 Memory Bank Protocol（在 system prompt 中检测 protocol_version: memory-bank/v1），以 Protocol 为准：
| 情况 | 行为 |
|---|---|
| Protocol 存在 | 按 Protocol 的 trigger/skip/invoke 规则执行 |
| Skill 与 Protocol 不一致 | 视为漂移，优先遵循 Protocol |
| Protocol 不存在 | 按 Skill 的 fallback 规则执行（见 reader.md） |
原则：Plugin 提供最小行为闭环，Skill 提供完整规范和 fallback。
初始化、迁移或刷新 Memory Bank。
/memory-bank-refresh
执行流程：
详见 writer.md 的 refresh 流程。
memory-bank/
├── MEMORY.md # 唯一入口（项目概述 + 当前焦点 + 路由规则）
│
└── details/ # 详情层（按需读取）
├── tech.md # 技术栈 + 命令
├── patterns.md # 技术决策 + 代码约定
├── progress.md # 完成状态 + 历史变更
├── design/ # 设计文档（index.md 可选）
│ └── *.md
├── requirements/ # 需求文档（index.md 可选）
│ └── REQ-*.md
└── learnings/ # 经验记录（index.md 可选）
└── *.md
Plugin 自动注入 memory-bank/MEMORY.md 内容到 system prompt。
检测 memory-bank/ 目录
├─ 存在 MEMORY.md → 直接注入内容
├─ 存在旧结构 → 提示运行 /memory-bank-refresh 迁移
└─ 不存在 → 提示运行 /memory-bank-refresh 初始化
read({ filePath: "memory-bank/details/xxx.md" })注意：memory-reader 是"升级路径"，不是默认调用。日常读取使用 direct read。
当用户问题涉及项目上下文且满足升级条件时，同步调用 memory-reader 获取结构化上下文包：
proxy_task({
subagent_type: "memory-reader",
description: "Memory Bank context read",
prompt: "Goal: Load minimum repo context needed.\nConstraints: Read memory-bank/MEMORY.md first, then details/ as needed. No secrets. Max 10 files.\nOutput: Context Summary (Markdown) + ONE YAML block with evidence, conflicts, open_questions.\n\nUser request: {question}"
})
升级触发条件（仅在以下场景调用）：
冲突检测：memory-reader 发现记忆与实现冲突时，会报告给主 Agent，建议调用 Writer 更新。
详见 reader.md
流程（跨 turn）：
详见 writer.md