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. 输出摘要
   ├─ 项目当前阶段
   ├─ 最近完成的工作
   └─ 下一个任务建议
```

---

## 输出格式

```markdown
## 上下文恢复完成

### 项目信息

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

### 当前状态

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

### 最近活动（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 会自动检查：

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

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

---

## Hooks 配置（可选）

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

```json
{
  "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 分钟的重复工作。