用途:扫描现有仓库,合并各范围工作者的证据,写出描述当前系统的 as-is Memory Bank 文档,用于在规划变更前建立可靠基线。
前置条件:位于仓库根目录;.memory-bank/ 骨架已存在,若没有先运行 mb-init。
主要流程:
- 建立协议与任务目录:.protocols/MAP-CODEBASE/ 下的 plan.md、progress.md、verification.md、handoff.md,可选 decision-log.md;以及 .tasks/TASK-MB-MAP/。plan 必须包含 MB-SYNC(链接 .memory-bank/workflows/mb-sync.md)。
- 并行启动扫描子代理,以 ./agents/shared-repo-scanner.md 为基础提示;最多 5–7 个并行,范围不重叠,建议范围包括工具/CI、后端/服务、前端/UI、数据层、测试/质量;每个子代理写 .tasks/TASK-MB-MAP/TASK-MB-MAP-S-0X-final-report-<code|docs>-01.md。
- 强制 fan-in:写最终文档前读取全部报告,合并为单一提纲,解决矛盾或标记为“needs verification”,并在 progress.md 记录使用了哪些报告、冲突如何解决、遗留问题。
- 综合生成 as-is Memory Bank:product.md、architecture/、spec-index.md、glossary.md、invariants.md、runbooks/、contracts/、states/、testing/index.md、index.md,参考 references/synthesis-checklist.md。
关键限制:无 prd.md 时不得创建或填充 .memory-bank/epics/、features/、tasks/*.task.json 中的真实路线图任务;空骨架可保留。映射是记录现状而非规划。概览文档须区分事实(证据:路径/命令/日志/测试)与推断(明确标注)。
后续:基线建立后向用户索取 prd.md,再运行 mb-from-prd 规划增量;在全新上下文中运行 mb-review;按 mb-sync.md 执行 MB-SYNC 并追加 changelog。完成标准:任务目录含范围报告,.memory-bank/ 以证据描述现状,记录矛盾与开放问题,并已向用户索取 PRD 增量。