mcpField
H
handoff

handoff

github.com/boshu2エージェントワークフロー4501.4k 回インストール1 日前に更新
リポジトリ

handoff について

handoff は、後続のコンテキストが検証して作業を引き継げるよう、事実に基づくセッション記録を作成するエージェントスキルです。時系列の説明ではなく、正確な証拠パス、明示された不明点、許可された保存先を重視します。

主な機能

  1. 01証拠パス付きで完了事項を記録
  2. 02未解決のリスクと不明点を区別
  3. 03引き継ぎ先の認可を確認
  4. 04セッションと作業の関連を保持
  5. 05成果物のパスを返して終了

活用シーン

  1. 01完了済みと未完了のリポジトリ作業を記録
  2. 02検証可能なセッション情報を別のエージェントへ共有
  3. 03中断したセッションの識別情報の不足を記録
  4. 04呼び出し側が認可した場所に引き継ぎを作成

インストール

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

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

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

同梱ファイルreferences/.gitkeep

詳細

引き継ぎ

次のコンテキストが、作成者の記憶を信頼せずに正確なパスと事実に基づいて作業できるため、引き継ぎが機能します。読者が成果物自体から確認できない行は、引き継ぎではなく飾りです。

プロンプト

Write a handoff for this session in agentops-wt/train2-c: goal was
migrating regen to Go, I finished cli/internal/gates/regen.go and left
scripts/regen-all.sh untouched, tests are green, and the next context
still needs to update docs/CI-CD.md. Write it to .agents/ao/handoff/.

正常に機能している状態

説明文を読まなくても、トレースで次のことを確認できます。

  • 完了した各項目に、時系列の説明ではなく、cli/internal/gates/regen.go のような正確な証拠パスが記載されています。
  • 成果物は呼び出し元が指定した許可済みパスに保存されます。新しい CDLC の証拠には、明示的に選択された Git 管理外の場所が使われます。
  • その成果物の正確なパスを読み戻すと、書き込まれた内容を確認できます。
  • 次のアクションとして記載されるのは、呼び出し元が提供した continuation テキストだけです。担当者、トラッカーの状態、判定は創作されません。

契約

別のコンテキストで読み取れる、事実に基づくセッション成果物を作成します。以下を含めてください。

  • 呼び出し元から提供された目標と概要。
  • 完了した成果物と、その正確な証拠パス。
  • 未解決の受け入れ事項、調査結果、因果関係に関する不確実性、リスク。
  • 範囲が限定された目標の場合、観測されたネイティブな停止/継続状態、測定された残りの許容量または明示的な測定上の不足、現在の HOLD インシデントに対する唯一のヘルパーがすでに使用されたかどうか(既存の証拠参照を含む)。
  • 任意の、呼び出し元から提供された継続テキスト。
  • 役立つ場合は、最善の範囲で確認した読み取り専用のリポジトリ ID。
  • 許可された起動時の関連付け参照、ソースストア/プロジェクト/作業の ID、観測されたランタイム/セッション/コンテキスト ID、または明示的な不明事項。
  • 個別に証拠で裏付けられた親リンクと再開リンク、観測の由来と打ち切り地点、利用可能な凍結済みソース境界とダイジェストを伴う、裏付け可能な作業範囲(セッションの関連付けに従ってください)。

呼び出し元は、ディスパッチ/開始時に作業の関連付けを記録し、起動時にネイティブなコメント/メタデータまたはランタイムの事実を通じて観測したネイティブ ID を記録します。引き継ぎでは終了時の証拠を追加しますが、作業とセッションの唯一のリンク、または最初のリンクになってはなりません。中断されたセッションについては、許可された起動時の記録とネイティブな観測で裏付けられる内容だけを再構成してください。引き継ぎの欠落、ソースの欠落、長さの不明、未観測の ID、または証明されていない関係は、明示的に不明のままにしてください。ID を捏造したり、複数の作業にまたがるセッション全体を 1 つのビードに割り当てたりしてはなりません。後の証拠によってリンクが解決した場合も、それ以前の不明/失敗の観測を保持してください。

関連付けメタデータを読み取ったりコピーしたりする前に、ソース所有者と受信者/モデル/宛先の認可を確認してください。BD/Dolt はバージョン管理されており、秘密情報の保管場所ではありません。必要に応じて許可された不透明なロケーターを使用し、認可されていない宛先には、制限付きの抜粋や機密性の高いパスを含めないでください。ロケーターを持っていても、アクセス権があることにはなりません。

次のアクションを推測したり、作業を選択したり、所有権を割り当てたり、成果物を使用したり、トラッカーまたは Git の状態を変更したり、判定を分類したり、再試行を管理したり、ランタイムを再起動したりしてはなりません。引き継ぎを読んでも、その内容を変更してはなりません。HOLD または NEEDS_OPERATOR と記載された報告は、ネイティブな目標が一時停止した証拠ではありません。実際に観測された状態と、引き続き必要なオペレーターの操作を記録してください。コンパクションや引き継ぎによって、許容量、修復上限、ヘルパーのインシデントがリセットされることはありません。知識が単調に正しく更新されるものとして提示せず、情報価値のある否定的な主張や撤回された主張も、その由来とともに保持してください。

名前付きの失敗モード — 楽観的な完了判定:証拠パスが存在しない作業について「完了」と記載し、次のコンテキストが実体のない情報を前提に構築されること。

アンチパターン:セッションを時系列で語ること(「最初にこれを試し、次に……」)。 是正策:成果物、パス、未解決のリスクといった終了時点の事実を記録し、作業の経緯は省きます。

成果物は、呼び出し元が所有する認可済みの引き継ぎ先に書き込んでください。新しい CDLC の記憶/エピソードの証拠には、呼び出し元が選択した、保護された Git 外部のロケーションが必要です。保存先の指定がない場合は不足として報告し、利用側のチェックアウトに代替ファイルを作成してはなりません。既存の要求対象の証拠はそのまま保持してください。単独の非 CDLC 引き継ぎでは、以下に示す明示的な要求証拠の既定値を維持します。恒久的な汎用引き継ぎストアはありません。誰にも使用されない成果物は作業用の一時ファイルです。

人間にとってより適切な場合、このスキルでは Markdown を作成してかまいません。以下に示す既存の ao session handoff および ao session rehydrate の JSON 互換動作だけでは、起動時の関連付けや外部 CDLC 保存先は確立されません。実際の保存先対応が呼び出し内容に合致するコマンドのみを使用してください。

以前のデフォルトとの互換性

.agents/handoff/ にすでに保存されている JSON アーティファクトは、引き続き読み取り専用の 証拠として扱われます。ao session handoff は新しい JSON を .agents/ao/handoff/ に書き込み、 ao session rehydrate は両方のディレクトリを検索して、辞書順で最も新しいハンドオフ ID を選択します。同じファイル名が両方に存在する場合は、正規の .agents/ao/handoff/ のコピーが優先されます。従来のファイルを移動または削除するコマンドはありません。 人が作成した Markdown の利用者には正確なパスが渡されるため、どちらのデフォルトもスキャンする必要はありません。このスキルを所有する契約が互換性の基準であり、別個の移行アーティファクトは不要です。

アーティファクトのパスを返して終了してください。

コメント