recap

v2026.09.24

回顾最近 N 天的 Claude Code 使用记录——扫描原始会话数据,按主题分组汇总"我都做了什么",并从个人操作系统视角输出模式、风险与增删建议。当用户说 /recap、"看看我这几天做了什么"、"回顾一下我最近的会话"、"这两天我用 claude 干了啥"、"活动回顾" 时使用。

GitHub
Install command
npx skhub add majiayu000/recap
Markdown
SKILL.md

Claude Recap — 近期活动回顾与操作系统审计

从原始行为数据(而非用户自述)回答三个问题:

  1. 我最近都在做什么?
  2. 里面有什么可复用的模式?
  3. 我的工作系统该加什么、该删什么?

与近亲 skill 的边界(不要重复造)

  • 深度认知分析(Dreyfus/Bloom 五层画像)→ 转交 cognitive-portrait
  • 组合违规核验(冻结仓库、未推送工作)→ 转交 better-audit
  • Codex 历史自省 → 转交 codex-retrospective
  • 本 skill 只做:轻量、无依赖、直接读 jsonl 的活动回顾 + 系统级建议

Step 1: 提取数据(确定性部分,用脚本)

脚本随本 skill 分发(scripts/extract_sessions.py)。Claude 安装位于 ~/.claude/skills/recap,Codex 安装位于 ~/.agents/skills/recap,先解析实际位置再运行:

SKILL_DIR=$(ls -d ~/.claude/skills/recap ~/.agents/skills/recap 2>/dev/null | head -1)
python3 "$SKILL_DIR/scripts/extract_sessions.py" --days 2
  • --days N 调整回看窗口(默认 2;周回顾用 7)
  • --json 输出结构化数据供进一步处理
  • 输出:每个主会话的机器、项目、窗口内起止时间、用户消息数、工具调用数、子 agent 数、体积、前 3 条用户消息
  • 统计只计入窗口内的消息;跨窗口 resume 的老会话会标 resumed,其窗口前的历史不会混入本次回顾

跨机器汇聚(可选)

scripts/sync_remote_sessions.sh 把远程机器的 ~/.claude/projects rsync 到本机 ~/.claude/remote-sessions/<host>/projects,extract 脚本会自动发现这些目录并一并扫描(会话标 @<host>):

"$SKILL_DIR/scripts/sync_remote_sessions.sh" starlight    # 或 RECAP_SYNC_HOSTS="host1 host2"
  • 前提:目标机器已配置 SSH 免密(~/.ssh/config 里的 host 别名)
  • 建议挂 cron 每日同步;某台机器同步失败会返回失败状态,避免误以为数据完整
  • 其他目录可用 --extra-root label=path 显式加入扫描;显式路径不存在时应先修正路径再继续

如果用户提到 Codex,补充检查 ~/.codex/sessions(如存在)并说明覆盖范围。

Step 2: 主题分组(LLM 分析)

把会话按意图而非项目分组。常见类别:

  • 库审计/改造("看看这个库有什么问题"类)
  • 元层面审计(读自己的记录、设计管理系统)
  • 方向/战略探索("我该做什么"、影响力)
  • 内容生产
  • 日常运维(诊断、清理)

每组列出:涉及项目、会话数、代表性原话(引用用户消息,不要改写)。

Step 3: 操作系统覆盖映射(固定维度,每次必做)

把 Step 2 的分组映射到六大个人操作系统,输出覆盖表。判定只依据本窗口内的会话证据,没有证据就标"未运转",不推测。

操作系统判定信号(会话中出现即计入)
编码生产库审计、spec/issue 生成、实现 PR、代码 review、构建修复、验证动作
本地/混合 AI 实验室GPU/推理调度、模型路由、gateway/proxy 运营、成本或质量监控
内容与知识合成信息源调研、深度阅读、文章/线程/脚本产出、素材整理
Agentic 编排与记忆多 agent 协调、workflow/harness 设计、memory 系统操作
成长与基础设施portfolio/goals 管理、billing/proxy 优化、工具链演进、机器运维
分发与影响力发布动作、仓库门面整改、增长实验、发布后数据回收

覆盖表格式(每行必须附会话 ID 证据或标注缺失):

| 操作系统 | 覆盖度 | 证据(会话ID)| 缺失环节 |
  • 覆盖度分四档:重度运转 / 有活动 / 未运转 / 有活动但闭环缺失(要指明缺上游还是下游)
  • 特别检查闭环完整性:内容系统看有无"发布后数据回流",编码系统看有无"验证收尾",实验室系统看有无"成本/质量监控"
  • 连续多次 recap 中"未运转"的系统 → 在建议区提示:是主动挂起(合理)还是资产闲置(该处置)

Step 4: 模式与风险识别

在分组之上找跨会话模式,重点检查:

信号说明
重复出现的 prompt 句式候选固化为 skill(引用 3 次以上的原话为证据)
流水线形态同一套步骤在多个项目上重复执行(如 审计→spec→实现→验证)
spec 通胀spec/issue 生成速度远超实现与验证速度
未闭环会话有生成动作但无验证动作的会话
救火占比诊断/修复类会话占总量的比例

Step 5: 输出增删建议

按以下格式收尾(遵守 W-11:事实标来源,推断标置信度):

## 你这 N 天做了什么(事实)
<分组汇总,每条附会话 ID>

## 操作系统覆盖表(事实)
<Step 3 的六系统覆盖表>

## 模式(推断,附置信度)
<跨会话模式,引用原话为证据>

## 建议(附前提假设)
- 该固化的:<重复 3 次以上的流程 → skill 候选>
- 该删的:<零触发的规则/skill、未闭环的 spec>
- 该警惕的:<spec 通胀、验证缺口等>

规则

  • 只读,不修改任何会话文件
  • 引用用户消息时保留原文,最多截断不改写
  • 建议数量克制:每类最多 3 条,宁缺毋滥
  • 若窗口内会话超过 30 个,先按项目聚合再分析,避免逐条展开
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

skills/recap

Default branch

main

Latest commit

3660f91

Tree SHA

88c367d