hand-off について
hand-offは、作業を記録し、スキルを導入していない新しいエージェントが別のハーネスで引き継げるようにするスキルです。所定の形式で文書を作成し、AGENTS.mdから参照できるようにします。
主な機能
- 01構造化された引き継ぎ文書の作成
- 02引き継ぎスレッドの継続と分岐
- 03ローカルまたは共有の記録
- 04AGENTS.mdポインターの更新
- 05形式に沿ったファイル検証
活用シーン
- 01進行中の作業を新しいエージェントに渡す
- 02派生タスクを別スレッドとして記録
- 03次回セッションに向けてリポジトリを整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dyrits/ skills --skill hand-offインストール後、Claude Code で/hand-offを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
apm.ymlagents/openai.yamlreferences/handoff-format.md詳細
新しいエージェントが、どのハーネスでもスキルがインストールされていなくても作業を引き継げるよう、引き継ぎドキュメントを作成します。まず handoff-format.md を読み、記載された形式に正確に従ってください。
手順
- ローカルか共有かを確定します。
.agents/handoffs/が.gitignoreに記載されている場合(ローカルのみ)、以前の引き継ぎが追跡対象の場合(共有)、またはAGENTS.mdにその旨の記載がある場合は、リポジトリの設定に従い、確認は不要です。それ以外の場合は一度だけ、ローカルのみの履歴として.agents/handoffs/を.gitignoreに追加するか、共有履歴として引き継ぎをコミットするかを尋ねます。 - スレッド内に配置します。
.agents/handoffs/を一覧表示します。このセッションが、すでに引き継ぎがあるスレッド(再開元のスレッド、または以前に自分が作成したスレッド)の続きであれば、そのスレッドの最新の引き継ぎを置き換えます。現在の作業から分岐したサイドタスクは、そこから分岐したスレッドとして開始します。それ以外は新しいスレッドとして開始します。 - 新しいファイルを作成します。 テンプレートのセクションを見出しの下に記載順で作成し、「再開するには」の段落も含めます。「状態」の主張を検証済みと記す前に、今すぐ確認してください(ファイルを読む、コマンドを実行するなど)。そうでなければ、仮定として記します。ユーザーが引数を渡した場合、それらは次のセッションの焦点を示します。その焦点に合わせて「目標」と「次の手順」を記述してください。
- ポインターを更新します。 形式の「ポインター」セクションに従って、最も近い
AGENTS.mdを更新します。このスレッドの行を置き換えるか、共有またはローカルのどちらの引き継ぎかを明記した行を追加してください。AGENTS.mdがない場合は、その行を含めて作成してください。 - 両方のファイルが形式に沿っているか確認します。 すべてのセクションが揃い、順番どおりであること、「再開するには」の段落がそのまま記載されていること、「置き換える対象」の行に実在するファイルが記載されていること、情報源にすでに記録されている内容をコピーしていないこと、機密情報が含まれていないこと、このスレッドに関する新しいファイル名を記した
AGENTS.mdの行がちょうど1行であることを確認します。 - フルパスを表示し、 次のセッションでは
AGENTS.mdを通じてファイルを見つけられること、またはパスを直接指定できることをユーザーに伝えます。
コメント
Markdown 対応