mcpField
C
catchup

catchup

github.com/camachoAgent 工作流581 次安装
代码仓库

关于 catchup

Catchup 是只读技能，从 Git、工作区文件、计划以及可用的 GitHub 和 Basic Memory 数据中重建项目与工作流上下文。它汇总当前进展、阻塞项和建议的后续操作，不修改文件。

主要功能

  1. 01收集 Git 和 worktree 状态
  2. 02读取工作流上下文与活动计划
  3. 03检查可用的 GitHub 和记忆数据
  4. 04汇总阻塞项与后续操作

适用场景

  1. 01切换分支或 worktree 后恢复工作
  2. 02识别阻塞项和待办项目任务

MCP 相关

Basic Memory MCP 可用时，会搜索与当前分支匹配的近期条目；不可用时跳过该查询。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/camacho/ai-skills --skill catchup

安装后在 Claude Code 中输入/catchup确认已加载。

详细介绍

Catchup — 上下文重建

此技能严格为只读。请勿编辑文件、创建分支或运行写入命令。

1. 收集数据（并行运行所有互不依赖的步骤）

  • 运行 git log --format="%h %s (%ar)" -20、git status 和 git worktree list
  • 读取 .branch-context.md（如果存在——检查当前工作目录和 worktree 根目录）。解析 YAML frontmatter：workflow_step、validate_round/validate_max、review_round/review_max、plan_review_chunk/plan_review_total/plan_chunks_approved
  • 读取 ai-workspace/MEMORY.md——记录任何进行中或受阻的事项
  • 读取 HANDOFF.md（如果存在）
  • 列出 ai-workspace/plans/（按 mtime 排序，最新的排在前面），并读取第一个文件名不以 .done.md 或 .executed.md 结尾的文件
  • 通过 MCP 搜索 Basic Memory 中与当前分支名称匹配的近期条目。如果 MCP 不可用，则静默跳过。
  • GitHub——先检查是否可用： 
    command -v gh >/dev/null 2>&1 && gh auth status >/dev/null 2>&1
    如果已通过身份验证，则并行运行： 
    gh pr list --state open
gh issue list --state open --limit 15
    如果 gh 不可用或未通过身份验证，请注明“GitHub CLI 不可用”并跳过。请勿尝试安装或进行身份验证。

2. 汇总

按以下格式展示结果。省略未找到数据源对应的部分（例如，没有 HANDOFF.md、gh 不可用）。无论内容是否为空，都要始终显示 Loop 状态和阻碍事项——缺少信息本身也很重要：

Branch:         <name> — <what we're building (from plan or branch-context)>
Worktree:       <path> (or "primary")
Last commit:    <hash> <message>
Uncommitted:    <staged/unstaged summary, or "clean">
Workflow step:  <N> — <step name> (from frontmatter, or inferred)
Loop state:     validate <round>/<max>, review <round>/<max>
Active plan:    <file> — <current phase> — <next action>
Blockers:       <list>
Open PRs:       <count — titles>
Open issues:    <count — top 5 titles>
Handoff:        <detail>

摘要之后，醒目列出阻碍事项和 TODO 项——剩余工作、CI 失败、过期分支、记忆中标记为阻碍的事项。这些内容应放在首屏，而不是脚注中。

3. 建议后续操作

根据收集到的状态，建议 2～3 项具体的后续操作。例如：

  • “继续构建——计划 X 目前处于步骤 5（构建）”
  • “运行 /validate——实现看起来已完成”
  • “解决阻碍事项：[描述]”
  • “审查未关闭的 PR #N——等待处理”
  • “着手处理问题 #N——进行中”

以以下内容结尾：“你想做什么？”

故障情况

  • 没有 .branch-context.md：根据 git 状态和计划文件状态推断工作流步骤。注明：“没有分支上下文——步骤为推断所得。”
  • 没有活动计划：注明“没有活动计划。”不要搜索 .done.md 文件。
  • 处于 main 分支：跳过分支上下文和计划查找。仅显示 git 状态、PR、问题和记忆。
  • Basic Memory MCP 不可用：静默跳过。
  • gh 不可用：显示“GitHub CLI 不可用——PR/问题状态未知。”

评论

支持 Markdown