mcpField
H
handoff

handoff

github.com/hu3rrorエージェントワークフロー053 回インストール今日更新
リポジトリ

handoff について

新しいセッション向けの引き継ぎ文書を作成するエージェント用スキルです。保存先や機密情報のマスキング、既存資料の参照方法を定め、作業開始前に後任エージェントが認識を確認するよう求めます。

主な機能

  1. 01引き継ぎ用に会話の状態を要約
  2. 02OSの一時ディレクトリに文書を保存
  3. 03既存資料を重複させず参照
  4. 04機密情報をマスキング
  5. 05次のエージェント向けスキルを列挙

活用シーン

  1. 01進行中の作業を新しいエージェントへ移管
  2. 02セッション間の引き継ぎ準備
  3. 03継続に必要な手順とリスクの記録

インストール

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

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

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

同梱ファイルagents/openai.yaml

詳細

次のエージェントが作業を引き継げるよう、現在の会話を要約した引き継ぎドキュメントを作成してください。OS の一時ディレクトリに保存し、パスを明示的に解決してください(Windows では $env:TEMP、Linux/WSL/macOS では $TMPDIR、なければ /tmp)。現在のワークスペースには保存しないでください。Windows ネイティブのツール(node、python、pi の write)に /tmp/... のようなパスを渡すと、代わりに C:\tmp\... に解決されます。そのため、Windows では解決済みの絶対パスを渡してください。

ドキュメントのパスを、コピーして貼り付けられる pi の @ メンションとしてユーザーに返してください。形式は、先頭に @ を1つ付け、絶対パスをスラッシュ区切りにして二重引用符で囲み、その行にはそれ以外の文字を入れないでください。例:Windows では @"C:/path/to/handoff-xyz.md"(AppData/Local/Temp 配下などの %TEMP% ディレクトリ)、その他の環境では @"/tmp/handoff-xyz.md"。

引用符は必須であり、飾りではありません。pi のプロンプトエディターでは、@ を入力するとファイルのあいまい検索ポップアップが開き、ポップアップが開いている状態で Enter キーを押すと、送信されずに一番上の候補が適用されます。@ の後に引用符なしのパス、またはバックスラッシュ区切りの Windows パスを入力すると、長い候補トークンとして扱われ、Enter キーを押したときにポップアップによって上書きされます。引用符で囲んだ形式(@"...")では、閉じ引用符でトークンが終わるため、ポップアップは開かず、貼り付けたパスがそのまま保持されます。閉じ引用符は必ず行末に置いてください。その後に . や / を付けると、新しい候補入力が始まります。

CLI から起動する場合に使う、スラッシュ区切りの引用符なしパスも記載してください(例:C:/path/to/handoff-xyz.md)。pi は pi @C:/path/to/handoff-xyz.md として起動してください。シェルは pi が @file 引数を解析する前に引用符を取り除くため、ここに引用符を付けるとパスを解決できません。

ドキュメントの冒頭には、次のエージェントに向けた引き継ぎの前置きを記載し、作業を始める前に必ず認識合わせを行うよう促してください。文面は次のとおりです。

あなたは引き継ぎを担当するエージェントです。このドキュメントと、参照されているすべての成果物を、ほかのことを始める前に最後まで読んでください。その後、目標、現在の状況、次のステップ、リスクの4点について、理解した内容を回答してください。作業を開始する前に、ユーザーの確認を待ってください。

ドキュメントには「推奨スキル」セクションを含め、次のエージェントが読み込むべきスキル(各 SKILL.md を読み、内容に従うこと)と、その読み込み順を記載してください。

仕様書、計画書、ADR、イシュー、コミット、差分など、ほかの成果物にすでに記録されている内容を重複して記載しないでください。それらはパスまたは URL で参照してください。

API キー、パスワード、個人を特定できる情報などの機密情報は伏せてください。

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

コメント