catchup 是一套结构化方法,用于快速理解 git 仓库、会议记录、冲刺进度、文档修订或系统日志中的近期变化,核心是高效回答“发生了什么变化、哪些重要”。
适用场景:加入进行中的工作或离开后返回;规划或审查交接之前;任何需要“发生了什么、下一步是什么”上下文的场合。不适用场景:需要详细 diff 分析时应改用 diff-analysis;需要完整代码审查时应改用 review-core。
激活方式:关键词包括 catchup、summary、status、progress、context、handoff;提示语如“get me up to speed”“current status”“summarize progress”。
渐进式加载:Git 场景加载 modules/git-catchup-patterns.md,并可考虑 sanctum:git-workspace-review 做初始数据收集;文档/笔记场景加载 modules/document-analysis-patterns.md;日志/事件场景加载 modules/log-analysis-patterns.md。始终可用 imbue:proof-of-work、TodoWrite 工作流和结构化输出。
必需的 TodoWrite 项:catchup:context-confirmed(边界已确立)、catchup:delta-captured(变更已枚举)、catchup:insights-extracted(主题已识别)、catchup:followups-recorded(行动已记录)。
四步方法:第一步确认上下文,定义范围(git 分支、冲刺、会议)、基线(上次状态)和当前目标;第二步捕获增量,枚举变更项及指标,优先处理源码/配置/文档而非生成产物;第三步提取洞察,逐项说明变更内容、动机、影响(测试/风险/依赖),并汇总为主题;第四步记录后续事项,包括测试、文档、审查、阻塞项、问题,若无则明确说明。
输出格式包含 Summary(2-3 句主题与风险概述)、Key Changes(逐项列出内容/原因/影响)、Follow-ups(带负责人的行动清单)、Blockers/Questions(待解决问题)。验证方式:运行命令并加 --help 标志以确认可用性。
集成:使用 imbue:diff-analysis 做风险评估,imbue:proof-of-work 保证可复现,sanctum:git-workspace-review 获取 git 数据,并按需输入 brainstorming 或 writing-plans。
令牌节约:引用路径和行号而非复制内容,汇总输出,推迟深度分析,使用渐进式加载。
退出标准:完成四个 TodoWrite 项,捕获上下文/增量/洞察/后续事项,使相关方无需重读来源即可理解状态。