mcpField
H
handoff

handoff

github.com/borkwebエージェントワークフロー858 回インストール3 日前に更新
リポジトリ

handoff について

handoffは、新しいエージェントが作業を引き継ぐための文書を作成するスキルです。固定の8セクション構成と安全な一時保存先を定め、再開に必要なコンテキストを残します。

主な機能

  1. 01安全な一時ディレクトリにhandoff.mdを作成
  2. 02固定の8セクション構成を使用
  3. 03指定された引数に合わせて目標を調整
  4. 04実行環境、役割、モデル設定を保持
  5. 05パスと再開に必要な情報を記録

活用シーン

  1. 01新しいエージェントに会話の続きを引き継ぐ
  2. 02セッション間でコンテキストと次の手順を共有
  3. 03実行台帳と結果パスを使って作業を再開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/borkweb/skills --skill handoff

インストール後、Claude Code で/handoffを入力して読み込まれたか確認します。

詳細

現在の会話を要約した引き継ぎドキュメントを作成し、新しいエージェントが作業を続けられるようにしてください。プラットフォームの安全な一時ディレクトリ用ヘルパーを使って一意の一時ディレクトリを作成し(Node の場合は fs.mkdtempSync(path.join(os.tmpdir(), "handoff-")))、その中に handoff.md を書き込んでください。絶対パスを報告してください。

ユーザーが引数を渡した場合は、次のセッションで取り組む内容の説明として扱い、それに合わせてドキュメントを調整してください。

実際の受信ランタイムと、解決済みの役割/モデル設定を Key context に記載してください。無関係な作業の引き継ぎに、オーケストレーションのデフォルト設定を持ち込まないでください。引き継ぎを書いても、ワーカーは起動せず、アクティブなモデルも変更されません。 完了した実行を引き継ぐ場合は、台帳とスライスごとの結果パスを Pointers に含め、再開に必要な認可、凍結されたゲート、未解決の裁定、エージェント ID を保持してください。引き継ぎ先の Codex は、エージェントが稼働中かどうかを確認する必要があります。前のセッションの ID があっても、ワーカーがまだ稼働している証拠にはなりません。

ドキュメントの構成

引き継ぎ先は別のエージェントであるため、構成は固定です。以下の見出しを、記載どおりの文言で、順序も変えずにちょうど 8 つ作成してください。履歴ではなく、目的と次のステップから始めてください。新しいエージェントが上から確認してすぐに作業を始められるようにします。

  1. # Handoff: <short title> — 作業内容を示すタイトルを 1 行で記載します。
  2. ## Goal — 次のセッションで達成することを 1~2 文で記載します。引数が渡された場合は、その内容を反映します。
  3. ## Current state — 現在までに完了し、動作している内容を記載します。箇条書きで、過去形にします。
  4. ## Next steps — 次に実行する具体的な作業を、順番に記載します。それぞれ命令形にします(「X を接続する」「Y を実行する」など)。最も重要なセクションです。初見でもすぐに作業を始められるよう、実行可能な内容にしてください。
  5. ## Open questions / blockers — 未解決の判断事項、回答待ちの事項、既知のリスクを記載します。
  6. ## Key context — 決定事項とその理由、注意点、すでに除外された行き止まりなど、見落としやすい重要情報を記載します。新しいエージェントがコードやリンク先の成果物を確認すればわかる内容は省きます。
  7. ## Pointers — 詳細を記載した成果物へのパスや URL を記載します。PRD、計画書、ADR、Issue、ブランチ、主要ファイル(path:line)などを参照してください。内容を転載せず、参照先を示します。
  8. ## Suggested skills — 次のセッションで使用するスキルがあれば、その用途とともに記載します。

ルール

  • PRD、計画書、ADR、Issue、コミット、差分など、他の成果物にすでに記録されている内容を重複させないでください。代わりに Pointers でパスや URL を参照してください。
  • セクションに記載すべき内容がない場合は、内容を水増ししたり捏造したりせず、その下に None. と記載してください。Open questions が空でも問題ありません。
  • 簡潔にまとめてください。引き継ぎは作業開始のためのものであり、会話の記録ではありません。

コメント