本文へ移動
cccskills

claude-handoffでClaude Codeの会話を引き継ぐ方法

cccskills 編集部読了 約 8 分

この記事の結論

こんな人に
Claude Codeで長い作業を続けて会話が膨らみ、新しいセッションに続きをきれいに引き継ぎたい人
入れると
  • /claude-handoffの一言で済み、要約を書いて新しいセッションに貼る手間がなくなる
  • 引き継ぎ先が同じ作業ディレクトリで名前付きで起動し、ジョブ一覧で見分けられる
  • 仕様書や計画はパスで参照され、次に使うスキルも要約に書き添えられる
向かない人
claude --bgが使えない環境の人や、短い会話で作業が終わる人には向きません

claude-handoffを入れると、Claude Codeの今の会話を要約し、新しいバックグラウンドエージェントに続きを任せられます。長い作業を続けている人に向いたスキルで、引き継ぎ先は同じ作業ディレクトリです。ここでは、呼び出したときに起きること、次の目的を絞った引き継ぎ方、インストール方法と注意点を説明します。

目次

使うとこうなる

claude-handoffを呼び出すと、今の会話が引き継ぎ用の要約になります。新しいエージェントはその要約を最初の指示として受け取り、バックグラウンドで動き始める仕組みです。引き継ぎ先の起動場所は現在の作業ディレクトリなので、同じリポジトリやフォルダからそのまま続きに取りかかれます。

/claude-handoff 次のセッションではログイン不具合の修正に集中する

この依頼を送ると、エージェントはまずここまでの会話を要約し、OSの一時ディレクトリにファイルとして保存します。次にclaude --bgでバックグラウンドエージェントを起動し、要約ファイルの中身を最初の指示として渡す流れです。起動コマンドはすぐに戻るため、元の会話が待たされることはありません。

新しいエージェントには「Fix login bug」のような、内容の分かる名前が付きます。名前が表示されるのは、ジョブ一覧、セッションの選択画面、ターミナルのタイトルです。起動したエージェントはclaude agentsでまとめて管理します。

claude-handoffでできること

claude-handoffを使えば、会話の要約から次のエージェントの起動までが1回の呼び出しで終わります。自分で要約を書いて新しいセッションに貼り付ける作業は要りません。主な働きは次の4つです。

会話を引き継ぎ用に要約する

長い会話の経緯を、新しいエージェントが続きを始められる形にまとめます。要約はファイル経由で起動コマンドに渡されます。そのため要約にバッククォートや$が含まれていても、シェルがそれを実行したり展開したりすることはありません。

次のセッションの範囲を絞る

呼び出すときに引数を付けると、それが次のセッションの目的として扱われます。「ログイン不具合の修正」と添えれば、要約もその作業に合わせて書かれます。次に何をするかが決まっている場面で、余計な経緯を引きずらずに済むのが利点です。

参照資料と次に使うスキルを整理する

仕様書、計画、ADR(設計判断の記録)、Issue、コミット、差分に残っている内容は、要約に書き写しません。代わりにパスやURLで参照するので、同じ情報が二重に載ることはありません。要約には「suggested skills」の節も入り、次のエージェントが呼ぶべきスキルが書かれます。

秘密情報を除いて渡す

要約はそのまま次のエージェントへの指示になります。このため、APIキーやパスワード、個人を特定できる情報は要約から伏せる決まりです。

インストール方法

インストールの方法は、コマンドを1行実行するか、エージェントに頼むかの2通りです。コマンドで入れる場合は次の1行を実行します。Claude CodeやCodexなど、入れる先は実行時に選べます。

npx skills add https://github.com/mattpocock/skills --skill claude-handoff

エージェントに頼む場合は、次の文面をそのまま送ってください。中身の確認を先に済ませてから配置する手順になっています。

次の Agent Skill をインストールしてください。
https://github.com/mattpocock/skills/tree/main/skills/in-progress/claude-handoff

まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/claude-handoff/、Codex なら ~/.agents/skills/claude-handoff/ に配置してください。

手で配置する場合の置き場所は次の表のとおりです。

入れる先全プロジェクト共通プロジェクト単位
Claude Code~/.claude/skills/プロジェクトの.claude/skills/
Codex~/.agents/skills/プロジェクトの.agents/skills/

配布元はGitHubのmattpocock/skillsで、スター数は320478です。claude-handoffは、このリポジトリのin-progressフォルダに置かれています。エージェントが自動では呼び出さない設定なので、使うときは/claude-handoffと名前を指定してください。

使い方の例

基本は、作業の区切りで/claude-handoffを呼ぶことです。次の目的が決まっていれば、引数として添えてください。

/claude-handoff

引数なしで呼ぶと、今の会話をまとめた要約が作られます。新しいエージェントはその要約を指示として受け取り、同じ作業ディレクトリのバックグラウンドで起動する仕組みです。

/claude-handoff ログイン画面の不具合修正だけに集中できるように引き継いで

目的を添えると、要約はその作業に合わせた内容になります。引き継ぎ先には作業内容の分かる名前が付くので、ジョブ一覧で他のエージェントと見分けるのに困りません。

/claude-handoff docs/plan.mdの計画に沿って実装を進める

計画をファイルに残してあれば、要約はその内容を書き写さず、パスで参照します。新しいエージェントは要約と計画ファイルを手がかりに、同じ作業場所で続きを始めます。

注意点

前提として、claude --bgでバックグラウンドエージェントを起動できるClaude Codeの環境が必要です。引き継ぎ先の起動にはclaudeコマンドを使います。Codexに配置する場合も、このコマンドが動く環境が欠かせません。

引き継ぐ前に、決まった仕様や計画をファイルやIssueに書き出しておくのがおすすめです。そうしておけば、要約はそれらをパスやURLで参照します。なお、要約自体の保存先はOSの一時ディレクトリです。

秘密情報を伏せる指示はスキルに入っています。それでも会話でAPIキーやパスワードを扱った場合は、呼び出すときに「秘密情報は要約に入れない」と添えておくと安心です。

ライセンスはMITです。入れる前にはSKILL.mdを読み、外部への送信や認証情報の読み取りがないかを確かめてください。

関連スキル

同じmattpocock/skillsには、長い作業を区切りながら進めるときに組み合わせやすいスキルがあります。

chief-of-staffは、長期的な目標に向けて、複数のサブエージェントの作業を調整するスキルです。利用者との対話を続けながら、作業環境や規約の改善も進めます。1本ずつ引き継ぐより大きな単位で、作業全体を回したい場面向けです。

ask-mattは、状況に合う関連スキルと、それを使う順序を案内します。次のエージェントにどのスキルを使わせるか迷ったときの相談先です。

まとめ

claude-handoffは、長くなったClaude Codeの会話を要約し、新しいバックグラウンドエージェントに続きを任せるスキルです。引き継ぎ先は同じ作業ディレクトリで、分かりやすい名前を付けて起動します。

次の目的を添えれば要約の焦点が絞られ、仕様書や計画はパスやURLで参照されます。長い作業を区切りながら進めたい人は、cccskillsのページから試してください。

よくある質問

引き継いだあと、元の会話はどうなりますか
起動コマンドはすぐに戻るので、元の会話はそのまま続けられます。新しいエージェントはバックグラウンドで動き、claude agentsで管理します。
引き継ぎ先のエージェントはどこで確認できますか
確認先はclaude agentsです。起動時に付いた名前が表示されるのは、ジョブ一覧やセッションの選択画面、ターミナルのタイトルです。複数のエージェントを動かしていても区別できます。
Codexでも使えますか
Codexの置き場所に配置すること自体はできます。ただし、引き継ぎ先の起動にはclaude --bgを使うため、Claude Codeのコマンドが動く環境が必要です。
会話中に扱ったパスワードは要約に入りますか
スキルには、APIキーやパスワード、個人を特定できる情報を伏せる指示が含まれています。とはいえ、要約は次のエージェントへの指示になります。秘密情報を扱った会話では、除外するよう添えて呼び出すと安心です。

このスキルを試す

claude-handoff の入れ方とインストールコマンドは、cccskills のスキルページにまとめてあります。

この記事は、公開されている SKILL.md と cccskills の紹介文をもとに AI(Claude)が下書きし、cccskills 編集部の方針に沿って推敲・公開しています。正確な仕様はスキルのページで原文を確認してください。

他の記事