元記事: claude-handoffでClaude Codeの会話を引き継ぐ方法(cccskills)
スキルのページ: claude-handoff
この記事の結論
claude-handoffを入れると、Claude Codeの今の会話を要約し、新しいバックグラウンドエージェントに続きを任せられます。
長い作業を続けている人に向いたスキルで、引き継ぎ先は同じ作業ディレクトリです。
ここでは、呼び出したときに起きること、次の目的を絞った引き継ぎ方、インストール方法と注意点を説明します。
claude-handoffを呼び出すと、今の会話が引き継ぎ用の要約になります。
新しいエージェントはその要約を最初の指示として受け取り、バックグラウンドで動き始める仕組みです。
引き継ぎ先の起動場所は現在の作業ディレクトリなので、同じリポジトリやフォルダからそのまま続きに取りかかれます。
/claude-handoff 次のセッションではログイン不具合の修正に集中する
この依頼を送ると、エージェントはまずここまでの会話を要約し、OSの一時ディレクトリにファイルとして保存します。
次にclaude --bgでバックグラウンドエージェントを起動し、要約ファイルの中身を最初の指示として渡す流れです。
起動コマンドはすぐに戻るため、元の会話が待たされることはありません。
新しいエージェントには「Fix login bug」のような、内容の分かる名前が付きます。
名前が表示されるのは、ジョブ一覧、セッションの選択画面、ターミナルのタイトルです。
**起動したエージェントはclaude agentsでまとめて管理します。
**
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 agentsで管理します。
確認先はclaude agentsです。
起動時に付いた名前が表示されるのは、ジョブ一覧やセッションの選択画面、ターミナルのタイトルです。
複数のエージェントを動かしていても区別できます。
Codexの置き場所に配置すること自体はできます。
ただし、引き継ぎ先の起動にはclaude --bgを使うため、Claude Codeのコマンドが動く環境が必要です。
スキルには、APIキーやパスワード、個人を特定できる情報を伏せる指示が含まれています。
とはいえ、要約は次のエージェントへの指示になります。
秘密情報を扱った会話では、除外するよう添えて呼び出すと安心です。
claude-handoffは、長くなったClaude Codeの会話を要約し、新しいバックグラウンドエージェントに続きを任せるスキルです。
引き継ぎ先は同じ作業ディレクトリで、分かりやすい名前を付けて起動します。
次の目的を添えれば要約の焦点が絞られ、仕様書や計画はパスやURLで参照されます。
長い作業を区切りながら進めたい人は、cccskillsのページから試してください。
この記事は cccskills の読みもの「claude-handoffでClaude Codeの会話を引き継ぐ方法」の転載です。
スキルの詳細とインストール方法は cccskills の claude-handoff のページ にあります。