mcpField
H
hand-off

hand-off

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

hand-off について

hand-offは、作業を記録し、スキルを導入していない新しいエージェントが別のハーネスで引き継げるようにするスキルです。所定の形式で文書を作成し、AGENTS.mdから参照できるようにします。

主な機能

  1. 01構造化された引き継ぎ文書の作成
  2. 02引き継ぎスレッドの継続と分岐
  3. 03ローカルまたは共有の記録
  4. 04AGENTS.mdポインターの更新
  5. 05形式に沿ったファイル検証

活用シーン

  1. 01進行中の作業を新しいエージェントに渡す
  2. 02派生タスクを別スレッドとして記録
  3. 03次回セッションに向けてリポジトリを整理

インストール

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

$npx skills add https://github.com/dyrits/skills --skill hand-off

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

apm.yml
agents/
openai.yaml
references/
handoff-format.md

詳細

新しいエージェントが、どのハーネスでもスキルがインストールされていなくても作業を引き継げるよう、引き継ぎドキュメントを作成します。まず handoff-format.md を読み、記載された形式に正確に従ってください。

手順

  1. ローカルか共有かを確定します。 .agents/handoffs/ が .gitignore に記載されている場合(ローカルのみ)、以前の引き継ぎが追跡対象の場合(共有)、または AGENTS.md にその旨の記載がある場合は、リポジトリの設定に従い、確認は不要です。それ以外の場合は一度だけ、ローカルのみの履歴として .agents/handoffs/ を .gitignore に追加するか、共有履歴として引き継ぎをコミットするかを尋ねます。
  2. スレッド内に配置します。 .agents/handoffs/ を一覧表示します。このセッションが、すでに引き継ぎがあるスレッド(再開元のスレッド、または以前に自分が作成したスレッド)の続きであれば、そのスレッドの最新の引き継ぎを置き換えます。現在の作業から分岐したサイドタスクは、そこから分岐したスレッドとして開始します。それ以外は新しいスレッドとして開始します。
  3. 新しいファイルを作成します。 テンプレートのセクションを見出しの下に記載順で作成し、「再開するには」の段落も含めます。「状態」の主張を検証済みと記す前に、今すぐ確認してください(ファイルを読む、コマンドを実行するなど)。そうでなければ、仮定として記します。ユーザーが引数を渡した場合、それらは次のセッションの焦点を示します。その焦点に合わせて「目標」と「次の手順」を記述してください。
  4. ポインターを更新します。 形式の「ポインター」セクションに従って、最も近い AGENTS.md を更新します。このスレッドの行を置き換えるか、共有またはローカルのどちらの引き継ぎかを明記した行を追加してください。AGENTS.md がない場合は、その行を含めて作成してください。
  5. 両方のファイルが形式に沿っているか確認します。 すべてのセクションが揃い、順番どおりであること、「再開するには」の段落がそのまま記載されていること、「置き換える対象」の行に実在するファイルが記載されていること、情報源にすでに記録されている内容をコピーしていないこと、機密情報が含まれていないこと、このスレッドに関する新しいファイル名を記した AGENTS.md の行がちょうど1行であることを確認します。
  6. フルパスを表示し、 次のセッションでは AGENTS.md を通じてファイルを見つけられること、またはパスを直接指定できることをユーザーに伝えます。

コメント