handoff について
handoffは、新しいエージェントが既に得られた知見を調べ直さずに作業を続けられるよう、独立したコンテキストをまとめるスキルです。範囲、判断、根拠、未完了事項、継続手順を引き継ぎます。
主な機能
- 01確認済みの事実と出典の記録
- 02判断と代替案の記録
- 03作業範囲と委任権限の保持
- 04未完了事項と再開条件の保持
- 05永続的な引き継ぎファイルの作成
活用シーン
- 01新しいエージェントへの作業引き継ぎ
- 02セッションをまたぐ判断の保持
- 03待機や中断後の作業再開
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ doodledood/ manifest-dev --skill handoffインストール後、Claude Code で/handoffを入力して読み込まれたか確認します。
詳細
新しいエージェントが、このセッションで確立した内容を再検討したり学び直したりせずに作業を続けられる、自己完結したコンテキストペイロードを作成してください。次のセッションで何をするかを踏まえて、何を記録し、何を省くかを決めてください。
苦労して確立した内容を記録してください。そうしなければ新しいセッションでやり直すことになる情報をすべて含めてください。引き継ぐ各項目には、その根拠も添えてください。結論だけでなく、実際に機能している状態を受け手が引き継げるようにします。例(あくまで参考であり、必須ではありません): 決定事項を引き継ぐ際は、検討した選択肢と採用理由も記載します。検証済みの事実には、検証方法(ファイルと行番号、コマンド出力、ドキュメントの URL など)を添えます。未解決の事項には、何をもって解決とするかを記します。
次のセッションに割り当てられた作業と範囲、委任された選択の出所と制限、維持されている決定事項、受け入れ済みの成果物やバージョンを記録してください。現在の撤回事項と待機条件を、再開手順とともに保持してください。この引き継ぎで与えられる権限は、呼び出し元が持つ権限を超えてはなりません。後続作業の提案は、あくまで提案として記載してください。
現在の受け入れに関する主張、厳守すべき要件、作業中に認められた変更の自由度に加えて、根拠や、判断を再検討する条件を含む重要なレビュー判断を記載してください。過去の評価だけでなく、未完了の必須作業や、更新が必要な証拠も記録してください。
受け手がアクセスできる場合は、正しい成果物やバージョンへの参照を優先してください。アクセスできない場合は、必須の仕様と継続に必要な状態をペイロードに含め、参照できない情報源と証拠の限界を明記してください。ローカルパスだけではホスト間で引き継げません。無関係な履歴をコピーしたり、受け手がすでに読める内容を重複させたりしないでください。
これからの作業が該当する場合は、次のエージェントが呼び出すべきスキルを明記してください。受け手は、引き継がれたツール群を把握していない可能性があります。
認証情報、トークン、個人データは伏せてください。このペイロードはセッション終了後も保持され、別のエージェントのプロンプトにそのまま使われる可能性があります。秘密情報の値ではなく、それが保存されている場所(環境変数名や保管庫のパスなど)を示してください。
形式はエージェントに任せます。セクション名、見出し、文章か箇条書きか、順序は、目的に合わせて決めてください。
~/.manifest-dev/handoffs/handoff-{timestamp}-{id}.md に出力してください(ディレクトリを作成し、~ は $HOME / %USERPROFILE% を表します)。{timestamp} は UTC の YYYYMMDD-HHMMSS 形式、{id} はランダムな 16 進数 4 文字としてください。パスが空いている場合に限りファイルを作成し、同じ秒に書き込まれた二つの引き継ぎが互いに上書きされないよう、すでに使用されている場合は新しい {id} を生成してください。OS の一時ファイル削除後も引き継ぎが残る、永続的な保存先とします。ホームディレクトリに書き込めない場合に限り、書き込み可能な一時パスにフォールバックしてください。引数が以前の引き継ぎへのパスである場合は、まずその内容を読み、現状を反映した新しい文書を作成してください。追記ではなく、全面的に書き直します。