catchup
Skill2 starsChanged 5 months agoMITView on GitHub
「前回見て以降どうなった」「久しぶりに状況確認」「最後に見てから何が変わった」「差分だけ教えて」「catchup したい」「未読を消化したい」と聞かれたら、opshub MCP の catchup tool を叩いて前回 catchup 以降に積み上がった差分 (新規 source / 期日超過を含む open commitment / 新着 Slack demand) だけを優先度順に要約する。catchup は seen-marker を前進させる非破壊 write tool で、実行すると「ここまで見た」が記録される (次回 catchup はその先の差分だけを返す)。LLM 推論ループは外部ホスト (Claude Code 等) 側、本 skill は手順書のみで実処理を持たない。pair: personal-brief (期間ベースの総覧) に対し、catchup は seen-marker ベースの「前回以降の差分」に特化する。
26 other projects use a version of this.
Adopted by
Most recently taken up by
- LilMGenius/paperthintheir own version, first seen Nov 15, 2026
- shortcuts/dotfilestheir own version, first seen Nov 8, 2026
- blamechris/chroxytheir own version, first seen Nov 8, 2026
- saksham10arora-dotcom/everything-claude-codextheir own version, first seen Nov 1, 2026
- Avijit07x/claude-dbtheir own version, first seen Oct 13, 2026
- poshan0126/dotclaudetheir own version, first seen Oct 8, 2026
Used with
Projects with it also use wrapup, explain and 4 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
Skeln-ioSkillwrapup
End-of-session closeout — commit, push, and optionally post a Slack summary. Use when you say "wrap up", "done for now", "save everything", or similar.
Also in 3 projects that use this
sunnyclinches44Skillexplain
Explains code using real-world analogies and ASCII diagrams
Also in 3 projects that use this
AWSSkillship
Finalize dev work on an issue branch — update docs, push, and open a PR.
Also in 4 projects that use this
BlockSkillplan
Draft a TDD, PRD, or lightweight plan in the conversation without committing it.
Also in 3 projects that use this
MicrosoftSkillhandoff
Compact the current conversation into a handoff document for another agent to pick up.
Also in 4 projects that use this
GoogleSkilltdd
Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.
Also in 4 projects that use this
Other versions26 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 26
- LilMGenius/paperthin★ 1.4ksame name
- poshan0126/dotclaude★ 871same name
- getsentry/sentry-wizard★ 297same name
- Avijit07x/claude-db★ 233same name
- DeL-TaiseiOzaki/claude-code-orchestra★ 199same name
- saksham10arora-dotcom/everything-claude-codex★ 96same name
- wilbeibi/catchup★ 81same name
- shortcuts/dotfiles★ 18same name
- blamechris/chroxy★ 8same name
- iopsystems/skills-mcp★ 6same name
16 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- announcement-draftSkill
- decision-rationaleSkill
- external-briefSkill
- find-documentSkill
- handoff-draftSkill
- inbox-triageSkill
- meeting-followupSkill
- meeting-prepSkill
- next-actionsSkill
- personal-briefSkill
- pr-reviewSkill
- reply-draftSkill
- researchSkill
- source-extractSkill
- announcement-draftSkill
- catchupSkill
- decision-rationaleSkill
- external-briefSkill
- find-documentSkill
- handoff-draftSkill
- inbox-triageSkill
- meeting-followupSkill
- meeting-prepSkill
- next-actionsSkill
- personal-briefSkill
- pr-reviewSkill
- reply-draftSkill
- researchSkill
- source-extractSkill
The file
Files
catchup — 前回見て以降の差分だけを優先度順に返す
opshub MCP server (opshub mcp serve、ADR-0022) 経由で「前回 catchup してから今までに積み上がった差分」だけを surface する。期間ラベル (今日 / 今週) を指定する personal-brief と違い、catchup は seen-marker (「operator が最後に catchup した時刻」を保持する singleton) を基準に差分を計算する (Phase 25-E、epic #566)。
非常駐原則 (ADR-0004 §(a) 形A) を維持する: opshub 側で能動的に「変更があったら通知する」runtime は走らない。本 skill はリクエスト駆動で、ユーザーが「前回以降どうなった?」と聞いた瞬間にホストが catchup tool を叩く。
personal-brief との違い (pair)
| 軸 | personal-brief | catchup |
| 基準 | 期間ラベル (今日 / 今週 / 先月) | seen-marker (前回 catchup 時刻) |
| 対象 | 期間内の主要な動き全般 | 前回以降に積み上がった差分のみ |
| 状態変化 | なし (read-only) | seen-marker を前進させる (「ここまで見た」を記録) |
| 用途 | 定点観測 / 振り返り | 久しぶりの復帰 / 未読消化 |
「今週どうなってる」は personal-brief、「前回見て以降どうなった」「久しぶりに状況確認」は catchup。
何が起きるか (host 側の流れ)
- ユーザーが「前回見て以降どうなった」「久しぶりに状況確認」「差分だけ教えて」のような表現で問い合わせる
- 外部ホスト (Claude Code 等) が本 skill を発火させる
- ホストが opshub MCP の
catchuptool (非破壊 write) を 1 回呼ぶ - 戻り値 (JSON) の 3 セクション (新規 source / open commitment / 新着 Slack demand) を集約し、ユーザー向けに要約する
- catchup の実行で seen-marker が前進する (次回 catchup はこの先の差分だけを返す)
呼び出し (MCP tool)
tool: catchup
input:
limit: 20 # オプション: セクションごとの表示件数上限 (件数 total は常に全差分を反映)
advance: true # オプション: seen-marker を前進させるか (default true)。
# ドライプレビュー (marker を動かさず差分だけ見たい) なら advance: false戻り値 (JSON):
{
"since": "2026-06-01T09:00:00+00:00",
"advanced_to": "2026-06-14T10:00:00+00:00",
"new_sources_total": 12,
"new_sources": [
{"id": "01...", "connector_name": "slack", "source_type": "slack_message", "title": "...", "url": null, "observed_at": "..."}
],
"open_commitments_total": 5,
"overdue_commitments_total": 2,
"open_commitments": [
{"id": "01...", "direction": "i_owe", "counterparty": "person:01...", "due": "2026-06-10", "text": "...", "overdue": true}
],
"new_demand_total": 3,
"new_demand": [
{"team_id": "T...", "channel_id": "C...", "channel_name": "#general", "demand_kind": "mention", "last_demand_user_id": "U...", "last_demand_excerpt": "...", "last_demand_permalink": "https://...", "last_demand_at": "..."}
]
}sinceがnullのときは初回 catchup (履歴全体が「未見」扱い)。advanced_toがnullのときはadvance: false(ドライプレビュー、marker 不変)。- 各
*_totalは全差分の件数、リストはlimitで切り詰められる。
3 セクションの読み方
- 新規 source (
new_sources) — 前回以降に取り込まれたsources行 (Slack / Gmail / Box / GitHub / MS365 / Google Workspace 等、connector 横断)。observed_at降順。「何が来たか」の入口。 - open commitment (
open_commitments) — 旗艦コミットメント台帳 (Phase 25-C、ADR-0042) の open な約束。期日超過 (overdue: true) を先頭に 出す。directionがi_oweなら「自分が負っている約束」、owed_to_meなら「相手に頼んで待っている件」。overdue_commitments_totalを最優先シグナルとして扱う。 - 新着 Slack demand (
new_demand) — 前回以降に更新されたslack_demand_digest行 (Phase 18-B、ADR-0033)。自分宛 @mention / DM のうち operator がまだ返していないもの。last_demand_permalinkを付けると Slack UI に直接飛べる。
出力フォーマット (ホスト側)
ホストが以下のような構造でユーザーに返す。具体的な文面はホスト側 LLM が決める (本 skill は構造のみ pin)。brief (ADR-0015) と同型の section grouping を seen-marker 起点で適用する。
# 前回 (<since>) 以降の差分
## ⚠️ 期日超過のコミットメント (overdue_commitments_total)
- [→ I owe] (due 2026-06-10) 〜を送る ← 最優先
## 自分宛の新着 Slack (new_demand_total)
- [mention #general] @alice: 「<excerpt>」 → permalink
## 新規に取り込まれた source (new_sources_total)
- [2026-06-13] slack/slack_message: 〜自律範囲
- 自律 OK —
catchupは非破壊 write tool (readOnlyHint=false/destructiveHint=false、ADR-0022 §(c))。marker 前進は「catch me up」の consented な結果なので確認なしで呼んでよい。 - ただし catchup は副作用として seen-marker を前進させる (durable state)。これは「次回 catchup の基準点を進める」だけの軽い前進で、external な送信や proposal の apply は伴わない。marker を動かしたくない (差分の二度見をしたい) ときは
advance: falseを指定する。 commitment.resolve/commitment.dismiss等の状態遷移やtask.createなどの durable write は本 skill では呼ばない (operator の明示操作 / 別 skill の責務)。
できないこと / やらない
- 外部 SaaS への投稿 / 通知送信 (ADR-0010 §禁止事項 7)
- 差分を能動的に push する (ADR-0004 §(a)、能動機能は当面持たない)。あくまでリクエスト駆動。
- コミットメントの督促 (外部送信) — 台帳は read signal、督促は行わない (ADR-0042 §督促境界 / ADR-0010 write-back ban)
- 期間ラベル (今日 / 今週) ベースの総覧 →
personal-briefskill の責務 (pair)
参考
- ADR-0004 (Agent Runtime Boundary、形A)
- ADR-0015 (Briefing、本 skill は seen-marker 起点で section grouping を応用)
- ADR-0022 改訂 (MCP Server Surface、
catchupread tool) - ADR-0042 (Commitment ledger、Phase 25-C) — open commitment セクションの根拠
- ADR-0033 (Slack mention / DM demand digest、Phase 18) — new_demand セクションの根拠
- epic #566 (秘書化 v1) / Phase 25-E (#570) — seen-marker +
opshub catchup+ 本 skill - docs/assistant-agent.md (Skill catalog SSOT、15 skills 責務マップ)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

