handoff について
Handoff は、エージェント間の簡潔な作業引き継ぎを作成・再開するスキルです。次の作業に必要な情報を記録しながら、機密情報のマスキング、分量制限、古くなった成果物の確認を行います。
主な機能
- 01引き継ぎファイルの作成・再開
- 02機密値のマスキング
- 03セクションと分量制限の検証
- 04参照成果物の変更確認
活用シーン
- 01現在の作業状況を別のエージェントに引き継ぐ
- 02保存済みの引き継ぎからタスクを再開
- 03認証情報を漏らさず次の手順を共有
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ prathamdby/ skills --skill handoffインストール後、Claude Code で/handoffを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
REFERENCE.mdreferences/create.mdresume.md詳細
引き継ぎ
ルートとプライバシー
デフォルトの作成先は <anchor>/handoffs/handoff-<YYYY-MM-DD-HHmmss>.md です。anchor はこのスキルの絶対ディレクトリです。「Save to 」はそのパスへの作成を指定し、「resume 」は再開を指定します。両方が指定されている場合、値が不足している場合、または必須の Context/Open tasks が不正な場合は、処理をブロックします。すべてのパスを絶対パスに解決します。
名前付きの現在のフォーカスは、保存されたフォーカスより優先されます。
トークン/Cookie、キー、パスワード/接続資格情報、非公開または認証が必要な URL、メールアドレス/個人を特定できる情報(PII)、証明書、環境変数の値を秘匿します。
該当する値には [REDACTED: token]、[REDACTED: password]、[REDACTED: private-key]、[REDACTED: pii]、または [REDACTED: url] を使用します。
環境変数の値は NAME=[REDACTED] とします。変数名、コマンドの形式、終了コード、成果物への参照は保持し、機密値は保持しません。
コマンドをコピー可能にするために、秘匿の度合いを弱めてはいけません。
差分/計画/ログ/トランスクリプト全体を含めてはいけません。
上限は 12 KB、未完了タスクは 8 件、成果物は 12 件です。各セクションは 1~5 個の箇条書きとし、任意のセクションが空の場合は省略します。
作成
- 書き込み可能なパス/親ディレクトリを解決します。
create | path | facts | redaction | written | terminalを記録します。 出力を書き込める状態になったら完了です。 - 実行可能な現在の事実を選びます。計画、ブランチ/PR/コミット、変更のあるパス、ブロッカー、長期的に有効な決定を含め、古くなった情報にはその旨を明記します。
references/create.mdを適用して、必須セクションとワークフローの状態を下書きします。 各事実が次のエージェントの行動に役立つ状態になったら完了です。 - 下書きに機密値がないか 2 回スキャンし、上限/セクションを検証して、同じディレクトリ内の一時ファイルを介してアトミックに置き換えた後、最終ファイルをスキャンします。 構成、上限、3 回のスキャン、既存ファイルの確認がすべて完了したら完了です。
- パス、記録した範囲、および
resume the handoff at <absolute-path>を報告します。 ファイルと再開の指示が揃ったら完了です。
再開
- パスを解決して読み込みます。ファイルが存在しない場合は、パスを示して BLOCKED とします。
resume | focus | artifact status | task | terminalを記録します。 必須の Context/Open tasks が有効になったら完了です。 references/resume.mdを適用して、パス、ブランチ/変更状態、コミット、PR、インストール済みスキルを確認し、現行/移動済み/欠落/古い情報に分類します。 参照先の成果物を読みながら機密情報を秘匿します。古い事実に基づいて行動できない状態になったら完了です。- 現在のフォーカスのもとで、ブロックされていない最優先のタスクを選び、そのタスクに必要な成果物のコンテキストだけを復元して着手します。タスクがない場合は、別の要約を作成せず、根拠を示して BLOCKED とします。 成功、実際のブロッカー、または確認待ちの段階に達したら完了です。
- 状況の変化と作業結果を報告します。依頼がない限り、新しい引き継ぎは作成しません。
最終状態は SUCCESS、BLOCKED、AWAITING_USER、INTERRUPTED とし、それぞれ根拠を示します。 中断された場合は、前回の検証後に変更された成果物を再検証します。