handoff について
新しいエージェントが会話全体を読み直さずに作業を再開できるよう、簡潔な引き継ぎ文書を作成するスキルです。次の目標、現状、未解決事項、関連資料、結果の返却方法を日付付きファイルに記録します。
主な機能
- 01次のセッションの焦点を特定
- 02日付付き引き継ぎメモの保存
- 03現状と未解決事項の記録
- 04関連するプロジェクト資料の参照
- 05長期的な記録との重複を回避
活用シーン
- 01別のスキルやエージェントへの切り替え
- 02別セッションへのサイドタスク依頼
- 03長い計画・実装スレッドの終了
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/handoffを入力して読み込まれたか確認します。
詳細
引き継ぎ
新しいエージェントが会話全体を読み直さずに現在の状態から続行できるよう、簡潔な引き継ぎドキュメントを作成します。
使用するタイミング
- ユーザーが
/handoff、「これを引き継いで」、「/prototype に引き継いで」、「引き継ぎを戻して」、「次のセッション向けに要約して」、「別のエージェントに続けてもらって」と依頼した場合。 - 長時間にわたる計画、プロトタイプ作成、診断、実装のスレッドで、焦点を切り替えるとき、または終了するとき。
- サイドクエストを別のセッションで進め、簡潔な判定結果を持ち帰る場合。
手順
- 引き継ぎ先を特定します。ユーザーが引数を指定した場合は、
/prototype、/tdd、「grilling session に戻る」など、次のセッションの焦点として扱います。 - 必要に応じて
.scratch/handoffs/を作成します。 - 引き継ぎ内容を
.scratch/handoffs/YYYY-MM-DD-<short-slug>.mdに保存します。現在のローカル日付と、引き継ぎ先またはトピックを表すスラッグを使用します。ファイルがすでに存在する場合は、上書きせず、短い数字の接尾辞を追加します。 - 書き込む前に、そのパスに既存のファイルがないか読み込み、既存のメモを上書きしないようにします。
- 次のエージェントに実際に必要なコンテキストだけを書きます。
内容
以下を含めます。
- 目標：次のセッションで行うこと。
- 現在の状態：すでに決定または完了したこと。
- 未解決の重要な質問。
- 関連する成果物：PRD、Issue、ADR、設計ドキュメント、プロトタイプのパス、コミット、差分、URL。
- 推奨する次のスキルまたはコマンド。
- 返却時の指示：このスレッドまたは親スキルに戻す結果。
PRD、計画、ADR、Issue、コミット、差分、プロトタイプのメモにすでに記録されている内容を重複して書かないでください。パスまたはURLを参照してください。
パターン
- 「/prototype に引き継いで」→ プロトタイプで検証する問い、関連するアプリやモジュールのコンテキスト、プロトタイプの成果物は使い捨てであることを説明します。
- 「引き継ぎを戻して」→ サイドクエストで分かったこと、成果物の保存場所、これによって可能になった判断を要約します。
- 「実装に引き継いで」→ 承認済みのPRD、Issue、設計成果物を示し、残っているリスクを記載します。
アンチパターン
- 引き継ぎをプロジェクトの全履歴にしないでください。
- 「作業を続ける」のような曖昧な指示は避け、次に行う具体的な手順を明記してください。
- 長期的に保持すべきプロジェクト上の決定を、引き継ぎだけに記載しないでください。
CONTEXT.md、ADR、Issue、PRDに記録すべき決定は、そこに記載してリンクしてください。
次の手順
次のセッションは、指定した引き継ぎ先のスキル（例：roblox-to-issues、roblox-debugging-bugfix、roblox-game-development-lifecycle）から開始します。サイドクエストから戻ったら、判定結果を再度 handoff で引き継ぎます。
コメント
Markdown 対応