【2】「次はどこから?」の説明はもう不要——handoff でエージェントの作業を丸ごと渡す方法(つるまいボランティアさん向け)
はじめに——ボランティアさんの「あの作業、どこまで進んだっけ?」
つるまい移動支援のウェブサイト改修やメンテナンス。その現場では、多くのボランティアさんが Telegram の AI エージェント を相棒に使ってくれている。
「予約フォームの色を変えて」「この文言を直して」「新しい連絡先を追加して」——要望は日々増える。すると起きるのが、エージェントの頭(コンテキスト)がいっぱいになって溢れる 現象だ。
一度溢れると、これまでの会話が見えなくなる。翌日、別のセッション(新しい会話)を始めたとき——
「えーと、前回どこまでやったんだっけ?」 「あのボタンの件、結局どうなった?」
そんな説明のやり直しが発生する。人間がエージェントに「状況」をゼロから教え直すのは、とても非効率だ。
そこで handoff(ハンドオフ) という仕組みがある。これを使えば、エージェント自身が「今どこまでやったか」を1枚のメモにまとめてくれる。そのメモを次のセッションに渡せば、ボランティアさんは何も説明し直さなくて済む。
この記事では、プログラミングに詳しくない方でも使えるよう、具体的な指示文(プロンプト)付きで手順を解説する。
handoff って何?——一言で言うと「引き継ぎ書を書かせる」
handoff は、David Ondrej 氏が公開している25のスキル(Agent Skills)の1つだ(前回の記事【1】で全体を紹介した)。
普通のエージェントは「会話が続く限り」しか仕事を覚えていられない。handoff は、会話を区切るときに、その瞬間の「真実の状態」を構造化されたメモに圧縮して出力する スキルだ。
出力されたメモには、こういうことが書かれている:
- Goal(目的):この作業のそもそものゴールは何か
- Current State(現在の状態):何が終わったか、何が途中か、何がまだか
- Key Decisions(決定したこと):なぜその方針を選んだか
- Traps(失敗した手法):こうやったらダメだった、という経験
- Relevant Files(関連ファイル):どのファイルのどこを触ったか
- Open Work(残りの作業):あと何をすれば完成か
人間がいちいち「あれをやって、これをやって」と指示しなくても、次のエージェントが 「あ、前回はここまで終わってて、次はこれね」 と一発で理解できる。
ボランティアさんの実践ステップ——3つの場面
場面A:作業の途中で「もう一杯になりそう」と感じたら
エージェントに、たった1文を送るだけでいい。
「今の作業の handoff メモを作って」
これだけ。エージェントが上のテンプレートに沿ってメモを書き、チャットに貼ってくれる。さらに ファイルにも保存 してくれるので、それをコピーして取っておけばよい。
場面B:翌日、新しいセッションを始めるとき
前回のメモ(handoff)を、新しいチャットの最初に貼り付ける。
(handoffメモをそのまま貼る) 「これを読んで、残りの作業を続けて」
これでエージェントは、あなたが何も説明しなくても前回の続きから再開できる。
場面C:複数のボランティアさんがいる場合
「Aさんが作った予約フォーム、Bさんが引き継いで修正を加える」という場合も同じだ。Aさんが handoff メモを作って共有しておけば、Bさんはそのメモを新セッションに貼るだけで、Aさんの文脈を丸ごと引き継げる。
「口頭で引き継ぐ」より、100倍正確で、100倍速い。
コツ——メモに「何を残してほしいか」を教える
handoff は、言われた通りにメモを作る。だから、「この作業に絞ってまとめて」 と焦点を合わせると、より使いやすいメモになる。
例えば、つるまいのウェブサイト改修なら——
「予約フォームの改修作業について handoff メモを作って。特に『送信ボタンの色変更』と『確認メールの文言修正』の2点に焦点を当てて」
こうすると、関係ない会話(天気の話とか)は省かれて、本当に必要な情報だけが残る。
なぜこれが「つるまい」にぴったりか
つるまい移動支援の現場には、技術に詳しい人も、そうでない人も、両方いる。
handoff の良いところは、誰でも「1文送るだけ」で専門的な引き継ぎ書が作れる ことだ。プログラミングの知識がなくても、「作って」「貼って」の2ステップで、エージェントの文脈を完璧に継承できる。
要望が増えすぎてエージェントが溢れても、怖くない。handoff メモがあれば、いつでも「別の頭」で再開できる。
これこそが、地域の小さなIT現場こそ恩恵を受ける AI の使い方だ。
おわりに
handoff は、エージェント同士を「つなぐ」技術だ。
人間がいちいち状況を説明する時代は、もう終わりにしよう。ボランティアさん、ぜひ明日の作業から「handoff メモを作って」を試してみてほしい。
次回の記事では、複数のエージェントを同時に動かす cmux や、自分でスケジュールを立てる agent-self-scheduling について、つるまいの現場目線で解説する予定だ。
(本記事は、実際の handoff スキルファイルの手順を基に、ボランティアの現場で使える形に翻訳して執筆した。)