retro

Retro — 由 LLM 驱动的会话回顾

在 Codex 上，从已加载的技能目录解析脚本路径，并使用原生发现读取器（find-org-skills.py --host codex），而不是 Claude 缓存路径。主机选择和覆盖范围限制：references/skill-discovery.md。

对会话或记忆积压执行一次 LLM 分析，检测摩擦点和可复用的经验，将每项归类到七个目标位置之一，并将获批的内容写入相应位置。

**核心原则：**不得静默写入——每次写入都需要获得批准。

模式

• /retro — 全面回顾：当前整个会话。
• /retro "<problem>" — 聚焦回顾：针对一个描述的问题。
• /retro outcome [session-id|--since N] — 根据结果回放过去的会话。
• /retro audit [--scope project|repo|skill] — 跨会话检查架构偏移。
• /retro promote — 将已写入的本地记忆重新归置到更高层级（绝不包括项目本地记忆）；只有在确认更高层级的写入成功后，才清空源位置。参见 references/promote-mode.md。
• /retro done — 完成定义检查关卡：七项有证据支持的检查（任务、发现、回顾、清理、问题、工单、时间），每项标记 ✅ / ❌ / ⏸ / N/A。只有在某个具名人员能够通过一项具名操作解决时，才使用 ⏸；结构上缺失的内容应标记为 N/A，并说明原因——没有人能够解决的 ⏸ 会导致整张表被跳过。每一行都是 ✅ 或 N/A 时，说 done。参见 references/done-mode.md。
• 自动触发 — 可选的 SessionEnd 钩子，默认关闭。它属于插件级别，不属于此技能目录：hooks/session-end.json 位于仓库根目录（参见 README 中的 “Optional auto-trigger”）。

流程（所有模式）

1. 机械预处理 — uv run ${CLAUDE_SKILL_DIR}/scripts/detect-mechanical.py（Promote 模式： uv run ${CLAUDE_SKILL_DIR}/scripts/scan-memory-inventory.py）。每个 Python 脚本都通过 uv run 运行：其标头声明需要 Python 3.11 或更高版本，而 python3 可能是较旧的解释器（macOS 自带 3.9）。它需要 --transcript-file，并且 根据内容定位会话记录——使用本次会话中的某个 token——绝不依据修改时间：多个会话会共享一个项目标识，因此最新的 JSONL 经常属于其他人的会话。Codex rollout JSONL 必须先使用 scripts/codex-transcript.py 转换；在 Windows 上，运行 uv run 前设置 PYTHONUTF8=1。调用方式和适配器限制见 references/workflow.md。 然后，对同一份会话记录运行 uv run ${CLAUDE_SKILL_DIR}/scripts/collect-review-findings.py（其标头也声明了 tree-sitter 解析器；直接运行 python3 会停止并显示提示信息）：收集会话 PR/MR 中的审查线程、机器人审查和评论、这些 PR/MR 关联的问题，以及通过 --feedback-file 提供的规范化问题跟踪反馈（供 B18–B20、D4、D6 使用）。子 Agent 的会话记录（<session id>/subagents/agent-*.jsonl）也会被读取；输出中的 transcripts 列出读取的所有文件。脚本打开的 PR（fleet 驱动程序的 opened.jsonl）不会出现在会话记录中：通过 --pr-list 传入该文件。通过所属集成解析相关的不透明 提示，绝不根据键的格式推断。参见 references/feedback-contract.md；覆盖不完整不代表没有反馈。
2. LLM 补充分析 — 推断信号，涵盖两类（摩擦点 + 经验 B16–B20）；过滤误报。
3. 跨会话补充分析（可选）— 使用 ${CLAUDE_SKILL_DIR}/scripts/scan-cross-session.py 扫描 JSONL。
4. 发现技能 — ${CLAUDE_SKILL_DIR}/scripts/find-org-skills.py — 并检查仓库的执行框架（project-harness-inspection.md）。
5. 分类（classification-heuristic.md）— 首先依据权威性，然后选择最广泛的 范围；绝不归入项目本地记忆。
6. 评估 — 阅读匹配技能的 evals/；提议一个 TDD 存根。
7. 提案 — 用文字说明原因和应用方法，分组列出，不超过 10 项；精简时保留经验。
8. 批准 — 逐项批准、编辑或拒绝提案。
9. 按目标位置写入；对于 Promote，最后清空源位置（需先确认写入成功）。
10. 报告。

边界

**范围：**会话结束／跨会话分析、技能 PR 路由、完成门禁。 跟踪器的身份与访问权限由所属集成负责；QA 和时间策略由项目／组织规则负责。核心功能不隐式指定跟踪器、不发现 CLI，也不设置组织专属的计费默认值。

**始终遵守：**大模型是主要分类器。补丁提交至源代码仓库，绝不提交至缓存。每个私有仓库都需确认。遵循 Conventional Commits。DCO 签署 （git commit -s）。保留提交签名。

**先询问：**技能匹配存在歧义、激活自动模式、私有仓库目标、脏工作树回退，以及任何会让笔记对团队可见的推广操作。

**绝不允许：**自动合并、静默写入、由运行框架臆造归属信息（用户规则要求披露时，必须披露）、跳过钩子（--no-verify）、修改缓存、硬编码静态技能列表、删除已清空的记忆（应使用墓碑）；在完成模式下，合并、打标签或部署，或触碰其他会话的容器、进程或工作树。

参考资料

文件	用途
references/feedback-contract.md	与跟踪器无关的证据和引用解析
references/friction-catalog.md	所有信号：摩擦 + 经验总结（A/B/C、B16–B20）
references/destination-taxonomy.md	七种目标位置
references/classification-heuristic.md	摩擦 → 目标位置映射
references/skill-discovery.md	在运行时查找技能
references/patch-workflow.md	源代码仓库补丁流程（绝不修改缓存）
references/eval-integration.md	用于上下文的评估 + TDD 存根
references/promote-mode.md	推广：先物化，再清空
references/done-mode.md	完成：七道关卡的结束检查
references/workflow.md	所有模式 + 阶段选择