プロジェクト
関連するタスクをプロジェクトで整理し、共通の目標、計画、実行コンテキストを与えます。
プロジェクトは、複数のタスクで完了する作業を整理するための単位です。プロダクトのリリース、移行、段階的に進める機能などが該当します。
1 件のタスクで説明できる作業にプロジェクトは不要です。プロジェクトが適しているのは、共通の目標を持ち、進捗をまとめて追跡したい、あるいはリポジトリや作業ディレクトリを共有したい一連の作業です。
プロジェクトの構成
| 内容 | 役割 |
|---|---|
| 名前、アイコン、説明 | 目標、範囲、長期にわたって有効な要件。説明はプロジェクト内で作業するエージェントの実行コンテキストに入ります。 |
| ステータス | planned、in_progress、paused、completed、cancelled。 |
| 優先度 | urgent、high、medium、low、none。 |
| リード（lead） | メンバーまたはエージェント。プロジェクトの調整役を示します。 |
| 開始日と目標日 | プロジェクトの計画期間。 |
| タスクと進捗 | プロジェクト内の作業と、その完了割合。 |
| リソース | 紐づけた GitHub リポジトリ、または特定のコンピュータ上のローカルディレクトリ。 |
プロジェクトとタスクの関係
1 つのプロジェクトは任意の数のタスクを含むことができ、1 つのタスクは最大 1 つのプロジェクトに属します。タスクはプロジェクト内で直接作成することも、タスクのプロパティでプロジェクトを選択・変更することもできます。
プロジェクトの進捗は、紐づくタスクから自動的に計算されます。
進捗 = ステータスが done または cancelled のタスク数 ÷ プロジェクト内の全タスク数cancelled はその作業がプロジェクトの範囲から終了したことを意味するため、進捗に数えられます。プロジェクトのステータスとタスクのステータスは互いに独立しています。すべてのタスクが完了してもプロジェクトは自動的に completed にならず、プロジェクトのステータスを変更しても中のタスクが一括変更されることはありません。
プロジェクトの説明と実行コンテキスト
エージェントがプロジェクト内のタスクを実行するとき、プロジェクトの名前と説明がその実行のコンテキストに追加されます。説明には、関連するすべての作業に必要な情報 — 目標、技術的な境界、成果物の取り決め — を書きます。1 件のタスクにだけ関係する要件は、そのタスクに書いてください。
リソースの追加
プロジェクトリソースは、どのコードとどの作業ディレクトリを使うかをエージェントに伝えます。
- GitHub リポジトリ: ランタイムが checkout できるリポジトリと、任意の ref を指定します。
- ローカルディレクトリ: 特定のコンピュータ上のランタイムを既存のディレクトリで作業させます。ディレクトリの内容はエージェントが直接変更します。
選び方と安全上の境界はプロジェクトリソースを参照してください。
プロジェクトリード
リードはメンバーまたはエージェントで、プロジェクトの調整役を示します。権限設定ではないため、プロジェクト内のタスクが自動的に割り当てられることはなく、エージェントをリードにしても自動的に実行されることはありません。実行を開始するには、これまでどおりタスクの割り当て、@メンション、またはオートパイロットのトリガーが必要です。
サイドバーへのピン留め
ピン留めすると、プロジェクトが自分のサイドバーに表示されます。ピン留めは個人の設定で、ほかのメンバーには影響しません。
作成、編集、削除
プロジェクトの作成と編集はワークスペースのメンバーなら誰でもできます。削除できるのは owner と admin だけです。
プロジェクトを削除しても中のタスクは削除されません。タスクは紐づけが解除され、ワークスペースにそのまま残ります。プロジェクトの説明、ステータス、リソースは完全に削除されます。
次のステップ
- プロジェクトリソース — GitHub リポジトリまたはローカルディレクトリを紐づけます。
- タスク — プロジェクト内の具体的な作業を作成・整理します。
- エージェント — エージェントのアイデンティティ、設定、Access を理解します。