用途：在 Claude Code 会话结束或声明完成时，对会话或记忆积压做一次 LLM 回顾，识别摩擦点与可复用经验，分类到七类去向，并在批准后落地。核心原则是无静默写入，每次落地都需批准。
主要模式：/retro 扫描整个当前会话；/retro "<problem>" 聚焦单个问题；/retro outcome [session-id|--since N] 按结果回放历史会话；/retro audit [--scope project|repo|skill] 检查跨会话架构漂移；/retro promote 将已写入的本地记忆向上迁移（不涉及项目本地记忆），验证向上写入后才清空来源；/retro done 是完成定义门禁，含七项有证据的检查（任务、发现、回顾、清理、问题、工单、时间），每项为 ✅/❌/⏸/N/A，仅当有具名人员可用具名动作关闭时才用 ⏸，结构性缺失用 N/A 并注明原因。Auto 为可选的 SessionEnd 钩子，默认关闭，属插件级配置。
流程：机械预检脚本 detect-mechanical.py（Promote 用 scan-memory-inventory.py），需 --transcript-file，且按内容而非修改时间定位转录；随后用 uv run 运行 collect-review-findings.py（其头部声明 tree-sitter 解析器，普通 python3 会报错），收集评审线程、机器人评审、会话 PR/MR 及其关联 issue 的评论，以及通过 --feedback-file 提供的规范化跟踪反馈；脚本打开的 PR 需用 --pr-list 传入。之后进行 LLM 富化、可选的跨会话富化、技能发现、分类（权威优先，再取最广范围，绝不使用项目本地记忆）、读取匹配技能的 evals 并提出 TDD 桩、生成不超过 10 条提案（含 Why 与 How-to-apply）、逐条批准/编辑/拒绝、按去向落地、最后报告。
边界：范围限于会话结束/跨会话分析、技能 PR 路由与完成门禁；跟踪器身份与访问、QA 与时间策略归所属集成或项目/组织规则。始终要求 LLM 为主分类器、补丁发往源仓库而非缓存、私有仓库逐次确认、Conventional Commits、DCO 签署（git commit -s）、保留提交签名。需先询问：技能匹配歧义、自动模式启用、私有仓库目标、脏工作树回退、任何使笔记对团队可见的迁移。禁止：自动合并、静默写入、跳过钩子（--no-verify）、修补缓存、硬编码技能列表、删除已清空记忆（用墓碑）；Done 模式禁止合并、打标签或部署，或触碰其他会话的容器、进程或工作树。