catchup

/catchup - 快速恢复上下文

在 /clear 后快速恢复项目上下文。核心原则：快速加载，精准定位，无缝继续。

核心理念

每次 /clear 后，Claude 需要重新了解项目状态。此命令自动读取关键文档和最近变更，快速恢复工作上下文。

---

执行流程

1. 读取核心文档
   ├─ CLAUDE.md（项目宪法）
   ├─ memory-bank/progress.md（当前进度）
   ├─ memory-bank/architecture.md（系统架构）
   └─ memory-bank/tech-stack.md（技术选型）

2. 查看最近 Git 变更
   ├─ git status（当前状态）
   ├─ git log --oneline -10（最近提交）
   └─ git diff HEAD~3 --stat（最近文件变更）

3. 检查会话历史（如有）
   └─ ~/.claude/sessions/ 目录下的最近会话文件

4. 识别当前状态
   ├─ 正在进行的任务
   ├─ 下一步工作
   └─ 待解决的问题

5. 输出摘要
   ├─ 项目当前阶段
   ├─ 最近完成的工作
   └─ 下一个任务建议

---

输出格式

## 上下文恢复完成

### 项目信息

- **项目**: [项目名称]
- **技术栈**: [主要技术]

### 当前状态

- **阶段**: [当前阶段]
- **上次检查点**: [时间]
- **进度**: [完成百分比或描述]

### 最近活动（Git）

[最近 5 条 commit]

### 最近完成
- [x] [最近完成的任务 1]
- [x] [最近完成的任务 2]

### 当前任务
- [ ] [正在进行的任务]

### 下一步
[建议的下一个动作]

### 需要关注
- [待解决的问题或注意事项]

***
已准备就绪，可以继续工作。

---

使用场景

场景	命令组合
新会话开始	/cc-best:catchup → 了解状态 → 继续工作
切换任务后	/clear → /cc-best:catchup → 开始新任务
长时间中断后	/cc-best:catchup → 回顾进度 → 继续
上下文压缩后	/cc-best:catchup → 恢复关键信息

---

深度恢复模式

/cc-best:catchup deep

当需要更深入的上下文恢复时：

1. 执行标准 catchup 流程

2. 额外读取
   ├─ 最近修改的源代码文件
   ├─ 相关的测试文件
   └─ 配置文件变更

3. 分析代码状态
   ├─ 未完成的 TODO 注释
   ├─ 临时代码标记
   └─ 调试代码残留

4. 生成详细报告

---

快速恢复模式

/cc-best:catchup quick

只读取最关键的信息：

1. 仅读取 memory-bank/progress.md
2. 获取"下一步"内容
3. 输出简短摘要

适用于：

• 已经熟悉项目
• 只是短暂中断
• 需要快速继续

---

与 Memory Persistence 配合

如果启用了 Memory Persistence hooks，/cc-best:catchup 会自动检查：

# 检查最近的会话文件
~/.claude/sessions/YYYY-MM-DD-session.tmp

# 如果存在，读取并显示
- 上次会话完成的内容
- 上次会话的注意事项
- 建议加载的上下文文件

---

Hooks 配置（可选）

在 settings.local.json 中配置自动 catchup 提示：

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "echo '[Session] 建议执行 /cc-best:catchup 恢复上下文' && ls -la ~/.claude/sessions/*.tmp 2>/dev/null | tail -3"
          }
        ]
      }
    ]
  }
}