用途：收集某一天或某时间窗口内的 AI 工具对话历史，按工作内容而非工具归类，生成带主题的工作回顾并保存为 Markdown。适用于日报、周报、月度总结、站会笔记、工作日志、工具使用模式分析，以及跨多个 AI 工具的工作流梳理。不适用于基于 Git 提交的代码变更回顾、实时智能体监控和生产力指标统计。
主要能力：按日期或滚动窗口提取对话历史；按内容分组并区分已请求、进行中、已完成三种状态；分析多工具切换模式；输出 TL;DR、概览、主题/项目、杂项或副项目、工具使用模式等结构；结果保存到 .agents/results/recap/ 目录，窗口范围使用 {start-date}~{end-date}.md 命名。
使用方式：通过命令行获取数据，例如 oma recap --date YYYY-MM-DD --json、oma recap --window 7d --json、oma recap --json（滚动最近 24 小时，非自然日）、oma recap --tool claude,codex --json。未指定日期时默认今天。窗口上限 30 天，超出会被截断并提示。CLI 不可用时可用 jq 处理 ~/.claude/history.jsonl 作为回退，仅覆盖 Claude 历史并需说明范围限制。响应语言遵循 .agents/oma-config.yaml 配置。
限制：完成状态必须有明确完成消息、回执或产物证据，仅凭提示词或工具调用不能判定完成；时间戳不明确时按配置时区处理并说明假设；数据稀疏时输出简短回顾并注明覆盖有限；历史不可用时报告缺失来源与请求范围。