用途：在合并分支或完成一项任务后执行复盘，把本次工作的经验沉淀到记忆层，核对 issue 状态，并验证阶段门禁（COMMIT checkpoint）。资料强调：在第 8 步（Step 8）通过前，不要宣告任务完成。
主要能力与流程（按资料顺序）： Step 0 记录 reflect 时间戳（date +%s 写入 .last-reflect-ts）。 Step 1 回顾会话工作：查看 git log --oneline -10，若有已完成的 plan（ai-workspace/plans/，已填 Outcomes & Learnings）则以其为主要来源，否则从 git 历史与会话事件推导，先建立候选经验清单。 Step 1b 核对 issue 关闭：扫描提交信息中的 closing 关键词（closes/close/closed、fixes/fix/fixed、resolves/resolve/resolved 加 #N），对每个编号用 gh issue view N --json state --jq '.state' 检查；仍 open 的仅警告、不阻断。 Step 2 归类经验：与仓库文件、路径、配置或项目约定相关的写入 MEMORY.md；跨项目通用模式、工具行为或偏好写入 Basic Memory vault；两者都符合则同时写入并互相交叉引用。 Step 2b 将经验评论到相关 issue：plan frontmatter 中的 Issue: #N 可直接评论；否则用 gh issue list 模糊匹配开放 issue 标题，但需用户确认后才发布。 Step 3 写入 MEMORY.md：采用并发写协议，不在当前 worktree 写入；克隆到临时目录，最多重试 3 次，基于当前文件状态重新推导条目、跳过已存在内容、不自动合并、不重放旧 diff；新增条目、清理超过 30 天的条目、保持 200 行以内（超出时总结最旧部分而非静默删除）；提交并推送，遇到 non-fast-forward 先 pull --rebase 回到步骤 1，3 次失败后停止并上报。成功后把主 worktree 的 main 同步到最新（必要时先 WIP 提交再 ff-only 合并，再 reset --soft 恢复）；主 worktree 不在 main 则跳过。 Step 4 写入 Basic Memory vault：先用 mcp__basic-memory__search_notes 去重，再用 write_note 或 edit_note，用 [[wiki-links]] 连接，每条笔记打当前项目标签；若 MCP 未连接则记录跳过并继续，不阻断。 Step 5 ADR 检查：出现重要架构决策、约定或反复模式时询问是否创建 ADR，是则按模板生成 ai-workspace/decisions/ADR-NNN-<slug>.md 并递增编号。 Step 6 从浮现的工作创建 issue：先去重，再处理复盘中的 TODO，以及 scratchpad.md 中 - [ ] 行（转为 issue 并改写为 - [x] → #N），普通项目符号不动。 Step 7 收尾 plan：确认 Outcomes & Learnings 已填后重命名为 .done.md。 Step 8 阶段门禁：读取 .branch-context.md；MEMORY.md 未更新且有内容时软阻断并警告，文件缺失或为空则仅警告不阻断。最后输出各层执行摘要。
使用方式：以上步骤按顺序执行，仅在明确的上报点才向用户升级。所需命令保持原样，包括 git log、gh issue view/list、git clone、git add/commit/push、git pull --rebase 等。
限制与未提供信息：资料未提供收费、价格、支持平台、效果数据或具体模型版本（提交信息中的 <model> 为占位符）；Basic Memory MCP 不可用时相关步骤会跳过；MEMORY.md 写入连续 3 次失败需人工合并。