1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code の /compact・/clear・/handoff はいつ打つ? ask-matt の判断順を1つの機能開発でたどる

1
Posted at

Claude Code で長いセッションを回していると、「そろそろ /compact か、いっそ /clear か」で手が止まることがあります。Matt Pocock の mattpocock/skills に入っている ask-matt スキルは、この判断を順番つきの質問にしています。

結論
/compact は最初に打つコマンドではなく、最後に残る選択肢です。フェーズの区切りで「このまま続けられるか」「文脈は捨ててよいか」「別の場所へ持ち出すか」「放置で終わるタスクか」を順に確かめ、どれにも当てはまらないときに /compact します。区切りの途中では、続けるかサブエージェントに切り出すかの二択です。

この記事は Skillselion の運営チームが書いています。元記事: 私たちが運営する Skillselion の英語版 ask-matt スキルの使い方ガイド(英語) をもとに、日本語向けに書き直しました。インストール数は skills.sh レジストリ、スター数は GitHub の値で、どちらも2026年11月16日時点です。

ask-matt とはどんなスキル?

ask-matt スキルのページ によると、インストール数は 852,196、mattpocock/skills リポジトリの GitHub スターは 325,247 です。自分では作業をせず、「今の状況ならどのスキルを使うか」を答えるルーター役です。SKILL.md に disable-model-invocation: true があるので、Claude が自分の判断で呼び出すことはありません。迷ったときに /ask-matt と打ち、状況を一文で伝えます。

導入はリポジトリ単位です。

# Claude Code
claude plugin install mattpocock-skills@claude-plugins-official
# ほかのエージェント
npx skills@latest add mattpocock/skills

最初に一度だけ setup-matt-pocock-skills スキル を実行し、課題トラッカーやドキュメント配置を設定しておきます。

「フェーズの区切り」とはどこのこと?

ask-matt は、セッション内のひとかたまりの作業(ヒアリング、実装、QA など)をフェーズと呼びます。判断するのはフェーズとフェーズの間だけです。

Compacting mid-phase makes the agent lose the thread.

出典: mattpocock/skills PHASE-BOUNDARIES.md

作業の途中で圧縮すると、エージェントが話の筋を見失う、という指摘です。

区切りではどの順番で考える?

上から順に確かめ、最初に「はい」になったものを選びます。

  • 続ける: 次のフェーズが今の会話をそのまま必要とするか、smart zone(SKILL.md では最新モデルで約150kトークン)に余裕があるなら、何もしない
  • /clear: ここまでの探索や決定が次の作業に関係ないなら、コンテキストを空にする。いちばん安い手
  • /handoff: 別のハーネス(Claude から Codex など)、別ディレクトリ、同僚への引き継ぎ、途中で見つけた脇道の切り出し。この4つだけ
  • サブエージェント: 手を離していても終わるほど範囲が狭いタスク(自動レビューなど)
  • /compact: 上のどれでもないとき。指示を添えて、要約に残す内容を指定する

/compact is the default, not the first reach.

出典: 同上

/compact は「既定」ではあっても「最初に手を伸ばすもの」ではない、という位置づけです。いきなり /compact から入ると、要約で潰れた決定について自信たっぷりに間違える新しいセッションができあがる、とも書かれています。

1つの機能開発でたどるとどうなる?

例として、既存の Web アプリに「CSV エクスポート」を足す流れで当てはめます。

ヒアリングからチケット化まで: 続ける

grill-with-docs スキル で要件を詰め、to-spec で仕様に、to-tickets でチケットに分けます。ask-matt はここを1つのコンテキストウィンドウで通すよう求めています。仕様は会話の推論そのものを材料にするので、要約を挟むと中身が抜け落ちます。

「文字コードは Shift_JIS も要る?」を試作で確かめる: /handoff

会話では決めきれず、動くもので確かめたい問いが出たら、試作は別ディレクトリで行います。別ディレクトリへ移るので、handoff スキル(1,138,613 インストール)の出番です。行きに /handoff、試作が終わったら学んだことを /handoff で持ち帰ります。

チケットごとの実装: /clear

チケットは自己完結しているので、implement スキルを1枚ずつ回し、1枚終わるごとに /clear します。前のチケットの文脈は捨ててかまいません。

実装後の QA: /compact

実装の文脈は QA に必要で、同じハーネス、同じディレクトリで、人も判断に加わり続ける。ここで初めて /compact が残ります。/compact we're going to QA this area のように次の作業を書き添えると、要約が QA に必要な部分を残します。

よくある失敗は?

  • 区切りの途中で /compact する。続けるか、残りをサブエージェントに出す
  • 何も持ち出さないのに /handoff する。手に入るのは持ち運べるファイルだけです
  • 関係のある文脈を /clear する。なぜそう作ったかは、差分を読み返しても戻りません

mattpocock/skills 全体の流れと旧スキルの対応は Matt Pocock のスキル全マップ、近い用途のスキルは ドキュメント・計画向けスキルのランキング で比べられます。原文は ask-matt の SKILL.md(GitHub) です。

出典: skills.sh レジストリ(2026年11月16日時点のインストール数)、mattpocock/skills(コミット 5863806)。

この記事を書いている私たちは Skillselion を運営しています。Skillselion は Claude Code、Codex、Cursor 向けのエージェントスキルを実際のインストール数で並べる独立したディレクトリで、Anthropic とも Matt Pocock 氏とも無関係です。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?