---
title: エージェントのワークフロー – Agent Teams ドキュメント
description: タスクのライフサイクル、かんばんボード、メッセージ、タスクログ、並列作業、ライブプロセス、チーム間コミュニケーションについて理解します。
lang: ja-JP
---

# エージェントのワークフロー

Agent Teams は、エージェントの作業をタスクの状態、メッセージ、ログ、レビュー可能なコード変更として可視化します。

## モード

| モード | 説明 |
| --- | --- |
| ソロ | 自己管理タスクを持つ 1 人のチームメイト |
| チーム | 並列で作業し、互いにレビューし合う複数のチームメイト |

どちらのモードも、同じかんばん、タスクログ、コードレビューの画面を共有します。

## タスクのライフサイクル

Agent Teams は、各タスクを 2 つの独立した次元で追跡します。それは作業ステータスとレビュー状態です。

| 次元 | 状態 | 説明 |
| --- | --- | --- |
| 作業ステータス | `pending`、`in_progress`、`completed` | タスクが待機中か、実際に作業中か、オーナーによって完了されたかを追跡します |
| レビュー状態 | `none`、`review`、`needsFix`、`approved` | 完了後のレビューフローのどの段階にタスクがあるかを追跡します |

かんばんボードはこれらを組み合わせたビューを表示しますが、2 つの次元は独立して動きます。

### 作業ステータスのフロー

| 段階 | 何が起こるか | オーナー |
| --- | --- | --- |
| Pending | タスクが作成されて準備完了だが、まだ誰も作業を開始していない | リードまたはユーザー |
| In progress | エージェントが作業し、ボードの MCP ツールでタスクの状態を更新する | チームメイト |
| Completed | オーナーが結果コメントを投稿し、タスクを done としてマークする | チームメイト |

### レビュー状態のフロー

| 段階 | 何が起こるか | オーナー |
| --- | --- | --- |
| None | タスクはまだレビュー中ではない（pending、in progress、または新しく completed の可能性がある） | — |
| Review | レビューが依頼され、レビュアーが差分と結果を確認する | レビュアー |
| Needs fix | レビュー中に変更が依頼され、オーナーが更新する必要がある | チームメイト（オーナー） |
| Approved | レビューに合格し、タスクが確定する | レビュアー |

### 計画 → In progress

チームメイトがタスクを開始すると、作業ステータスは `in_progress` になります。エージェントは自身の計画を記したタスクコメントを作成し、作業を続けます。すべてのネイティブツールのアクション（read、bash、edit、write）はタスクログにストリーミングされます。

### Completed → Review

チームメイトが作業を終えると、結果コメントを投稿し、作業ステータスを `completed` としてマークします。その後、リードまたはレビュアーがレビューを依頼してレビューフローを開始できます。

### Review → Approved

レビュー画面に表示された変更が問題なければ、レビューを承認します。タスクは確定され、その差分にひも付けられます。

::: warning 修正優先のレビュー
レビュー中にチームメイトへ変更が依頼された場合、チームメイトは修正内容を記したフォローアップコメントを投稿し、その後リードが承認できるようにすべきです。
:::

## かんばんボード

ボードは主要な操作画面です。次のことができます。

- オープン中、ブロック中、レビュー中の作業を一覧で確認する
- タスク詳細を開いてランタイムログを確認する
- 生のセッションファイルを読まずに変更をレビューする
- オーナーを割り当てる、または再割り当てする

::: tip
カードのクイックアクションボタンを使えば、詳細パネルを開かずにタスクの開始、完了、レビュー依頼ができます。
:::

## メッセージとコメント

| チャネル | 使うタイミング |
| --- | --- |
| ダイレクトメッセージ | エージェントの方向を修正する、簡単な質問をする |
| タスクコメント | 特定のタスクに属するメモ |

コメントは後のレビューのためにコンテキストを保持し、タスクのタイムラインに表示されます。

::: tip タスクコメントを優先する
特定のタスクに関する指摘であれば、ダイレクトメッセージを送るのではなく、そのタスクへのコメントとして追加してください。履歴を作業にひも付けたまま保てます。
:::

## タスクログ

タスク固有のログは、1 つの割り当てに関するランタイム出力、アクション、メッセージを切り分けます。次のことを把握するために使います。

- このエージェントは何を実行したか？
- なぜこのファイルを変更したのか？
- 別のチームメイトに助けを求めたか？
- どのタスクがこの差分を生み出したか？

### 検証チェックリスト

タスクが行き詰まっているように見えたり、その差分が切り離されているように見えたりするときは、次の順序でライフサイクルを確認します。

1. タスクに想定どおりのオーナーがいて、`in_progress` に移っている。
2. オーナーが計画または最初の進捗更新を記したタスクコメントを投稿している。
3. タスクログにタスクのウィンドウ内のランタイムアクティビティが表示されている。
4. ファイルの変更が同じタスク、オーナー、セッションにひも付いている。
5. 最終のタスクコメントに検証コマンドとその結果が含まれている。

より深いデバッグについては、[トラブルシューティング](/ja/guide/troubleshooting#task-log-triage)にある永続化された証跡のコマンドを使ってください。UI は作業用の画面ですが、永続化されたタスクファイル、受信トレイ、ランタイムの証跡が、起動や帰属に関する深刻なバグを解明するための情報源です。

## 並列作業のパターン

チームメイトは独立したタスクを同時に進められます。依存関係のリンク（`blocked-by`）を作成して、あるタスクが別のタスクの完了まで待つようにすることもできます。ボードでブロック中のレーンを監視し、一方のチームメイトがアイドル状態でもう一方が過負荷になっている場合はオーナーを再割り当てしてください。

## ライブプロセス

ライブプロセスのセクションは、エージェントがローカルサーバーやツールを起動したときに、URL と実行中のプロセスを表示します。アプリから直接 URL を開いて結果を確認できます。プロセスは、明示的に停止されるかランタイムが終了するまで登録されたままになります。

## チーム間コミュニケーション

チームがリンクされていると、エージェントは他のチームへメッセージを送れます。これはハンドオフ、共有ライブラリ、またはチーム間のステータス確認に使います。
