人向けに書かれたタスクは3語で済むこともある。「ログインのバグを直して」で通じるのは、相手が「どういう意味?」と聞き返してくれるからだ。しかしエージェント向けに書かれたタスクは、その会話を借りることができない。この違いは、無駄な実行、誰もレビューしない成果物、そしてステータス列が人々の思う意味をなさなくなったボードという形で表面化する。
AIエージェントのタスク管理とは、エージェントが実行し人が受け入れる仕事を、書き、割り当て、完了させるための作法である。本ガイドでは、それが機能するかどうかを決める3つの要素を扱う。エージェント対応タスクに含まれるもの、担当を人とエージェントにどう分けるか、そして実行が絡んだときにステータスとレビューが実際どう振る舞うかだ。以降の例はSharklyの実装に沿って説明するが、同じルールはエージェントを実行者として扱うあらゆるシステムに当てはまる。
TL;DR
エージェント対応タスクには、成果、スコープ、コンテキスト、そして完了をどうレビューするかが明記されている。担当には2つの枠がある。人は責任を担い、1つのエージェントまたはクルーが実行する。ステータスカテゴリが実行を左右するため、待機中のバックログ状態では実行は始まらず、そこから移動すると実行が始まりうる。また、キャンセル済みや重複の状態は進行中の実行を停止するが、完了済みは停止しない。タスクのステータスとエージェントの実行状態は別物であり、レビューは、後でやろうという意図ではなく、必ず人に届く名前付きの状態である。
エージェント対応タスクに含まれるもの
説明文こそがインターフェースである。エージェントがあなたの意図について知ることはすべてここから来る。加えて、タスクの各フィールドが運ぶ情報も同様だ。
役に立つタスクは、トピックではなく成果を明示する。そしてその説明文には、新しく参加した人やエージェントが作業を進めるために必要な情報を加える。
- この作業がなぜ重要か。
- スコープに含まれるもの、含まれないもの。
- 関連するファイル、リンク、例、または観察された挙動。
- 制約と、すでに下された決定。
- 完了をどうレビューするか。
最後の項目は、他のすべてを合わせた以上に重要な働きをする。2分で受け入れられる成果物と、リバースエンジニアリングしなければならない成果物の違いはここで生まれる。まずは小さく始め、作業を調査しながら洗練させていけばよい。タスクの説明文は改善されて当然なのだ。
残りはフィールドが担う。種類、ステータス、優先度、日付、ラベル、そして計画のコンテキストとなるプロジェクトやスプリントだ。エージェント向けに組み立てられる実行には、タイトルと説明文、現在のステータスと優先度、スペースとスプリントのコンテキスト、実行のきっかけとなったコメントを含む最近のコメント、エージェントの指示とスキル、リポジトリ、環境、実行設定などを含められる。説明文が薄いことを、優れたモデルが補ってくれるわけではない。
担当:枠は1つではなく2つ
エージェントのタスク管理で最もよくある設計ミスは、担当者フィールドを1つしか持たないことだ。
両者は分けておく。人は責任のために割り当てられ、スペースによって1人でも複数人でもよい。エージェントまたはクルーは実行の枠に割り当てられ、こちらは単一選択のままとする。タスクは両方を同時に持つことができ、担当者の集合を変えても実行者は変わらず、エージェントを割り当てても担当者は置き換わらない。
その見返りは、どのタスクもボットが所有することがないという点だ。成果物に判断が必要なときには、必ず名前が紐づいている。エージェントが間違えたときには、レビューの会話に参加者がいる。Claude Codeのプロジェクト管理に関する当社の解説では、イシューからマージまで単一のタスクで同じ分離を示している。
クルーも同じ実行の枠に入り、実行はリーダー優先で進む。リーダーエージェントが開始し、コンテキストを読み、必要に応じてメンバーを巻き込む。明確に定義された作業には1つのエージェントを、調整が必要な作業にはクルーを使うとよい。
ステータス:実行を制御する部分
エージェントが関わるようになると、ステータスは飾りではない。表示される各ステータスはカテゴリに属し、そのカテゴリがシステム上の意味を持つ。
| ステータスカテゴリ | 意味 | エージェント実行への影響 |
|---|---|---|
| バックログ | 待機中、未準備 | ここで作成または割り当てしても実行は始まらない |
| 未着手 | 準備完了、未開始 | バックログからここに移動すると、割り当てられたエージェントが開始しうる |
| 進行中 | 作業中 | 実行が進む。複数のステータスがこのカテゴリを共有できる |
| 完了 | 完了、終端 | 終端だが、すでに進行中の実行はキャンセルしない |
| キャンセル | 継続しない | タスクに対して開始された実行を停止する |
| 重複 | 他で表現されている | タスクに対して開始された実行を停止する |
ぜひ腹に落としておきたい帰結が2つある。バックログは実際の待機場所だ。タスクを準備し、エージェントを紐づけても、移動させるまで何も起きない。そして、何かを完了にすることは、それを停止することとは違う。本当に止めたい実行はキャンセルしよう。
2つ目のルールは、ライフサイクルのステータスとエージェントの作業状態は別物だということだ。タスクが進行中のステータスにある一方で、エージェントは作業中、人の返信待ち、人によるレビュー待ち、またはエラーの報告中でありうる。キュー済み、ディスパッチ済み、実行中、完了、失敗、キャンセルといった実行状態は実行の進捗を表すものであり、タスクを自動的に動かすことはない。この2つを混同すると、3つの成果物が未読のままなのにボードは健全に見える、という状況が生まれる。
レビュー:引き継ぎを明示する
エージェントは実行を、成果物を伴うか、質問を伴うかの、有用な2つの地点のいずれかで終える。どちらも人に届く必要がある。
人の返信待ち、レビュー待ち、失敗またはブロックされた作業は、注意を促すシグナルだ。これらは個人のキューに流れ込む。Sharklyではそれがエージェント受信箱であり、責任者はそこでタスクを開き、コンテキストの中で回答し、成果物をレビューし、あるいは再試行や再割り当てを判断できる。
コメントはタスク上に残る持続的な会話だ。新しいコンテキスト、レビューの指摘、決定事項にはコメントを使い、変わらない目標と受け入れ基準は説明文に置いて、現在の要件をすぐ見つけられるようにしておく。エージェントの担当者が準備できているタスクへのメンバーのコメントは、次の実行をキューに入れうる。これにより、レビューのフィードバックが別のプロセスを立ち上げるのではなく、作業を継続させるものになる。メンションはこれを変える。人にメンションしたり全体メンションを使ったりしても、それ自体ではエージェントの実行は始まらない。また、担当者を含めず他の対象にメンションしたコメントは、既定の実行を抑制する。
受け入れる前に、差分だけでなく根拠を読もう。実行ログには、実行がなぜキューに入ったか、いつ開始・終了したか、ツール呼び出しとランタイムイベント、トリガー元、失敗の詳細が表示される。受け入れとは、成果が正しいと人が判断することであり、どの実行状態もあなたの代わりにはできない。これらの状態を手作業で組み立てるのではなく最初から連携させたいなら、Sharklyをダウンロードしてほしい。
そのまま使いたいタスクテンプレート
エージェント向けタスクをうまく書くチームは、たいてい同じ骨組みに落ち着く。スニペットに保存して埋めるだけで、全体で3分ほどしかかからず、無駄な実行を1回節約できる。
Outcome: <what is true when this is done>
Context:
- Why this matters now
- Observed behavior, with the exact error or reproduction steps
- Files, links, or examples that are relevant
Scope:
- In: <the change you want>
- Out: <adjacent work the agent should not touch>
Constraints:
- Decisions already made, conventions to follow, things not to change
Review:
- How completion will be checked, and by whom
スコープ外の行は、最も早くその価値を示す。狭い目標だけを与えられ境界を伝えられていないエージェントは、頼んでいないものまで改善しがちで、その改善のたびにレビュー時間がかかる。触れてほしくないものを明示するほうが、触られたものをレビューするより安く済む。
避けるべき5つの失敗
- 担当者フィールドが1つだけ。責任と実行が混ざり合い、オーナーシップが消える。
- 完了した実行を完了した成果とみなす。実行が終わったことは、その変更が正しかったかどうかを何も語らない。
- 失敗した実行を反射的に再試行する。まずログを開こう。似て見えるベンダーのエラーでも、必要な修正は正反対であることが多い。
- レビューを溜め込む。レビューされていないエージェントの成果物は、未マージのプルリクエストよりも速く膨らむ負債だ。
- すでに知っている人向けにタスクを書く。受け入れ基準が頭の中にしかないなら、エージェントは推測している。
FAQ
エージェントはタスクのステータスを変更できますか? 制限の範囲内で可能です。タスクタイプのワークフローが利用可能なステータスを制約するため、エージェントはそのワークフローが許可するステータスしか選べません。
実行が進行中のときにコメントするとどうなりますか? 条件を満たすコメントは、並行する重複実行を始めるのではなく、次の実行サイクルに向けてキューに入れることができます。また、連続したコメントはまとめられるため、重複した保留中の実行は作られません。
エージェントの作業には別のタスクタイプが必要ですか? 通常は不要です。作業に大きく異なるフィールドセットやワークフローが必要な場合は別タイプを、軽い分類だけが必要な場合はラベルを使います。
通常のプロジェクト管理とどう違うのですか? 基本要素は同じですが、厳格さが違います。AIエージェントのプロジェクト管理に関する当社のガイドでは、実行者が廊下で確認の質問をできないとき、各基本要素に何が変わるかを扱っています。
