ハンドオフ
新しいエージェントが会話全体を再読せずに作業を継続できるようにするハンドオフドキュメントを作成します。トランスクリプトではなく、状態と意図をキャプチャしてください。
保存場所
ハンドオフは現在のプロジェクトリポジトリ内に保存してください。OS のテンポラリディレクトリやチャット内には絶対に保存しないでください。
- リポジトリのルートを特定します:
git rev-parse --show-toplevelを実行します。失敗した場合(git リポジトリでない場合)、カレントワーキングディレクトリにフォールバックします。 - そのルートに
handoffs/ディレクトリが存在することを確認し、なければ作成します。 handoffs/<slug>-handoff-<UTC-timestamp>.mdに書き込みます。<slug>はタスクから派生した短いケバブケースのトピックです(引数が渡された場合はそれも使用します)。例:notebook-proxy-review<UTC-timestamp>はYYYYMMDDTHHMMSSZ形式です(例:20260527T144059Z)。タイムスタンプにより各ハンドオフが区別され、既存のハンドオフを上書きすることはありません。
- 書き込み後、作成したファイルの絶対パスを出力します。
何を書くか
このスキルに引数が渡された場合は、それらを次のセッションの焦点として扱い、すべてのセクションをその方向に偏らせてください。
以下のセクションを使用してください。各セクションは所定の長さ制限内に収めてください。ハンドオフはポインタドキュメントであり、すべてを記録するものではありません。本当に空のセクションは、無理に埋めずに省略してください。
- ヘッダー — タイトル、日付(UTC)、および次のセッションの目的を1行で。 (≤5行)
- 目的 — 目標とその成功基準。 (≤3文)
- 現状 — 完了したこと、動作していること、検証済みのものと推定のもの。 (≤10箇条)
- 次のステップ — 次のエージェントのための具体的で順序付けされたアクション。 (≤8箇条)
- 重要な決定とその理由 — 確定した選択とその理由。次のエージェントが再検討しないようにするため。 (≤8箇条)
- 注意点 / 地雷 — すでに踏んだ罠、驚き、完了しているように見えてそうでないもの。 (≤8箇条)
- 関連ファイルと参照 — コード、PRD、計画、差分、イシューへのパスとURL。内容をインライン化せず、参照として示す。 (≤12エントリ)
- 未解決の質問 — ユーザーまたはさらなる作業が必要な未解決の決定事項。 (≤6箇条)
- 推奨スキル — 次のエージェントが呼び出すべきスキルと、その理由を1行で。 (≤6エントリ)
ルール
- 他の成果物(PRD、計画、ADR、イシュー、コミット、差分)にすでに含まれているコンテンツを重複させないでください。代わりにパスまたはURLで参照してください。
- 大きなファイルの内容やコマンド出力全体をハンドオフに貼り付けないでください。ソースを指し示してください。
- 機密情報や個人情報(API_KEY / SECRET / TOKEN / PASSWORD / PRIVATE_KEY に一致するもの、または個人データ)は編集してください。ローカルファイルパスは問題ありません。