mcpField
C
catchup

catchup

github.com/camachoエージェントワークフロー581 回インストール
リポジトリ

catchup について

Catchup は、Git、ワークスペース内のファイルや計画、利用可能な GitHub と Basic Memory の情報から、プロジェクトとワークフローの状況を再構成する読み取り専用スキルです。ファイルを変更せず、進行状況、阻害要因、次のアクションをまとめます。

主な機能

  1. 01Git と 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（存在する場合は CWD と worktree ルートを確認）。YAML フロントマターを解析します：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/ を一覧表示し（更新日時の新しい順）、.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 unavailable」と記録してスキップします。インストールや認証を試みないでください。

2. 情報をまとめる

調査結果を次の形式で提示します。データソースが見つからなかったセクションは省略します（例：HANDOFF.md がない、gh が利用できない場合）。Loop state と Blockers は、空でも必ず表示します — 該当情報がないことも有用な情報です：

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 を確認 — 対応待ちです」
  • 「Issue #N に着手 — 進行中です」

次の文で終わります：「何をしますか？」

失敗時の対応

  • .branch-context.md がない場合：Git の状態とプランファイルのステータスからワークフローステップを推定します。「ブランチコンテキストがありません — ステップを推定しました」と記載します。
  • 有効なプランがない場合：「有効なプランはありません」と記載します。.done.md ファイルは検索しないでください。
  • main ブランチ上の場合：ブランチコンテキストとプランの検索をスキップします。Git の状態、PR、Issue、メモリのみを表示します。
  • Basic Memory MCP が利用できない場合：何もせずスキップします。
  • gh が利用できない場合：「GitHub CLI が利用できません — PR／Issue のステータスは不明です」と表示します。

コメント

Markdown 対応