/catchup

description: 快速恢复上下文，了解项目当前状态
argument-hint: "[session-id]"
allowed-tools: Read, Glob, Grep, Bash

/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"
          }
        ]
      }
    ]
  }
}

---

恢复检查清单

/cc-best:catchup 执行后，确认：

• [ ] 了解项目的技术栈
• [ ] 知道当前所处的阶段
• [ ] 明确下一个要做的任务
• [ ] 了解最近的代码变更
• [ ] 知道有哪些待解决的问题

---

常见问题

Q: progress.md 不存在怎么办？

A: 提示用户执行 `/cc-best:setup` 初始化项目。

Q: Git 仓库不存在怎么办？

A: 跳过 Git 相关信息，只读取文档。

Q: 上次会话有未完成的任务怎么办？

A: 在输出中明确标注，建议优先处理。

---

注意事项

• 此命令**仅读取信息**，不修改任何文件
• 如果 memory-bank 文档不存在，会提示需要先初始化
• 配合 `/cc-best:iterate` 使用效果最佳
• 恢复后建议先确认理解正确，再开始工作

---

> **记住**：好的恢复是无缝继续工作的基础。花 30 秒执行 /catchup，避免 30 分钟的重复工作。