用途
Retro 是 agentops 操作循环中第 7 步（move 7）的最轻量捕获界面，用于把一次会话中的单条学习快速写入知识飞轮。它面向“洞察太小、不值得做完整 /post-mortem，但又可能有用、不应只留在交接文档中”的场景。捕获后的条目仍受晋升棘轮约束——retro 条目只是候选学习，尚未成为模式或规则。
主要能力
- 快速捕获单条学习到 .agents/learnings/ 目录。
- 支持快速模式：通过 /retro --quick "insight text" 或 /retro "insight text" 触发。
- 自动从内容生成 slug：取前几个有意义的词，小写，连字符分隔，最长 50 字符。
- 解析当前活跃的 bead：timeout_run 1 bd current 2>/dev/null || echo ""。
- 写入带来源字段的 Markdown 学习文件，包含 type、source、source_bead、source_phase、date、maturity、utility 等元数据。
- 自动分类：debugging、architecture、process、testing、security。
- 完成后输出确认信息，包含一行摘要和保存路径。
使用方式
快速模式命令：
- /retro --quick "insight text"
- /retro "insight text"
执行流程：
- 从内容生成 slug。
- 解析活跃 bead。
- 直接写入 .agents/learnings/YYYY-MM-DD-quick-<slug>.md，文件结构包含 frontmatter 与正文（What We Learned、Source 等）。
- 若没有活跃 bead，则有意省略 source_bead，但仍设置 source_phase: validate。
- 输出确认：Learned: <一行摘要> 与 Saved to: .agents/learnings/YYYY-MM-DD-quick-<slug>.md。
- 确认后立即返回。
示例：用户输入 /retro --quick "macOS cp alias prompts on overwrite — use /bin/cp to bypass"，代理生成 slug：macos-cp-alias-overwrite，解析活跃 bead，写入 .agents/learnings/2026-03-03-quick-macos-cp-alias-overwrite.md，并确认 Learned: macOS cp alias prompts — use /bin/cp。
适用场景
- 会话中出现单条、具体、可复用的洞察，需要快速留存。
- 洞察规模不足以触发完整 /post-mortem，但又不适合仅留在交接文档中。
- 需要为知识飞轮持续积累候选学习条目。
限制与注意事项
- 仅做单条观察的快速捕获，不包含 backlog 处理、激活与退役等完整回顾流程；需要完整回顾时使用 /post-mortem。
- 捕获内容过于笼统会降低价值，应具体化，例如写“auth tokens expire after 1h”而非“learned about auth”。
- 可能产生重复学习，写入前可用 grep 检查已有学习。
- 捕获后的条目仍为候选学习，受晋升棘轮约束，尚未成为模式或规则。
- 参考文档：references/retro.feature（可执行规范：单条观察捕获到 .agents/learnings/，棘轮下的候选，最轻量的 move-7 界面，soc-qk4b）。