用途
rrr 用于创建一次会话复盘(session retrospective),记录可复用的学习成果,并追加一行会话指标。其口号是“Reflect to grow, document to remember.”(反思以成长,记录以铭记)。它强调真实性:不得编造时间戳,也不得声称当前宿主无法提供的证据。
主要能力
复盘内容依据 TEMPLATE.md,涵盖会话元数据、摘要、时间线、技术细节、关键变更、架构决策、AI 日记、做得好/可改进之处、阻碍、诚实反馈、经验教训、后续步骤、相关资源与自我审计(写入的复盘以自我审计结束)。保存前会静默执行模板的校验门槛,仅做内部质量检查,不把检查清单写入文件。
经验教训仅在可迁移到其他项目时写入,采用包含 pattern、date、source、concepts 的 frontmatter 结构。指标文件在缺失时创建,包含 when、session、done、stuck、win、friction、error 列,每次运行追加一行;宿主无法提供会话 ID 时使用 unknown。还会查看最近七行指标,如果某个主题在 friction 或 error 中出现至少三次,则在复盘中展示一个重复模式章节,但不自动开 issue。
执行模式
提供五种调用方式:
/rrr:默认。同步前台执行,使用宿主会话时钟的真实时间加 git 提交时间,不使用后台代理;只读取时间戳,不读取对话内容。/rrr --light:最快速,仅包含时间线、摘要、经验教训与指标,跳过日记、反馈、阻碍与自我审计。/rrr --combo:先在前台产出草稿,再由后台挖掘证据富化同一文件,富化完成前标记为 pending。/rrr --bg:挖掘持久化的宿主会话并异步写入,宣告目标位置后立即返回。/rrr --fg:严格模式,仅使用当前对话上下文与仓库证据;不运行会话时钟,不检查持久化会话记录、JSONL、rollout 文件或会话数据库,也不启动隐藏挖掘代理。
--fg、--bg、--combo 互斥;若同时提供多个则停止并报告有效语法。未提供时使用默认前台路径。--light 可与前台路径组合。
使用方式与宿主契约
挖掘或委派前需读取 HOSTS.md,检测能力而非假定 Claude Code 路径、Claude JSONL、特定 agent API 或模型名。公开输出应称“session mining”而非“JSONL mining”。宿主适配器内部可读取 JSONL、rollout 文件或其他受支持来源,但必须归一化结果并保留来源归属。
若后台执行不可用:--fg 不受影响;--bg 回退到 --fg 并明确报告持久化挖掘不可用;--combo 保留前台产物,标记会话富化不可用,且不伪造完成通知。
每次写入 ψ/ 之前需检测 Oracle 根目录,不假定当前目录就是 Oracle 仓库,并优先通过 git 顶层目录配合 CLAUDE.md/AGENTS.md 与 ψ 目录/符号链接的存在来判断。
时间线统一使用 GMT+7(Asia/Bangkok),通过导出 TZ 来固定。时间来源优先级为:会话时钟 beats(宿主适配器,默认路径)→ 归一化会话证据(--bg/--combo)→ git 提交时间戳(任何模式)→ 收尾条目的当前时钟。绝不在两个 beat 之间插值。仅当完全不存在带时间戳的证据时才回退为有序的无时间项目符号;只要本次会话有提交,时间线就有真实时间。多日会话按 ### YYYY-MM-DD 分组。证据来源需记录为 session-clock、Claude adapter、Codex adapter、git-commit-times、context-only 或 unknown。
后台与组合模式
后台模式需在委派前解析全部路径与能力,向一个后台写入者提供当前上下文摘要、仓库证据、归一化会话证据(如可用)、目标路径、模板要求与反合理化规则;使用活动宿主自身的模型路由,绝不要求指定厂商模型。返回时给出解析后的绝对目标路径。若宿主无法在返回后保持工作运行,则使用文档化的前台回退,而不是假装任务仍在进行。
组合模式先同步写出完整可用的基于上下文的复盘,其时间线可含有序无时间条目,且必须包含 Session enrichment: pending;随后启动一个后台挖掘/写入者,原子更新同一文件:合并已验证的时间戳/证据,用来源与完成状态替换 pending 标记,并保留初始写入后用户所做的编辑。若宿主无法挖掘,则把 pending 标记替换为 session enrichment unavailable,并保留会话时钟生成的时间线,绝不填入估算值。
限制与禁止事项
- 默认执行模式为
--fg。 --fg从不挖掘持久化会话数据,也从不启动隐藏挖掘代理。- 只有
--bg和--combo允许挖掘持久化会话数据。 --combo是唯一前台加后台富化的模式。- 共享流程中绝不硬编码 Claude 存储、JSONL schema、agent API、team API 或模型名;宿主细节隔离在 HOSTS.md。
- 绝不编造时间戳、会话 ID、提交、文件或已完成的后台工作。
- 不为
/rrr创建协作团队或多代理分析树。 - 保持 vault 写入不进入 git 暂存区(不要
git add ψ/,它可能指向共享 vault)。 - 不用波浪号(~)为猜测的时间戳背书;等间隔的行(每 1 或 5 分钟)是从结束时间回填的特征,真实时间会不均匀聚集。
- 若时钟报告 evidence: none 且没有提交,应写 unknown,不修饰空白。
产物路径
路径基于 ψ 目录,并带 GMT+7 日期戳:
- 复盘:
$PSI/memory/retrospectives/$DATE_PATH/${HHMM}_${SLUG}.md - 经验:
$PSI/memory/learnings/${TODAY}_${SLUG}.md - 指标:
$PSI/memory/learnings/session-metrics.md
适用场景
适用于使用兼容代理宿主的开发者或团队,在工作会话结束后生成可审计的复盘与可迁移经验,尤其适合希望在多主机(如 Claude Code、Codex 等)间保持一致复盘流程、同时避免编造时间与证据的场景。
暂未提供的信息
资料未给出具体的安装命令、定价、许可协议与官方站点说明。