← Back to Home
AIエージェント ·

【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 スキルファイルの手順を基に、ボランティアの現場で使える形に翻訳して執筆した。)