トピック

トピックは、複数のタスクで完了する作業を整理するための単位です。プロダクトのリリース、移行、段階的に進める機能などが該当します。

1 件のタスクで説明できる作業にトピックは不要です。トピックが適しているのは、共通の目標を持ち、進捗をまとめて追跡したい、あるいはリポジトリや作業ディレクトリを共有したい一連の作業です。

トピックの構成

トピックとタスクの関係

1 つのトピックは任意の数のタスクを含むことができ、1 つのタスクは最大 1 つのトピックに属します。タスクはトピック内で直接作成することも、タスクのプロパティでトピックを選択・変更することもできます。

トピックの進捗は、紐づくタスクから自動的に計算されます。

進捗 = ステータスが done または cancelled のタスク数 ÷ トピック内の全タスク数

cancelled はその作業がトピックの範囲から終了したことを意味するため、進捗に数えられます。トピックのステータスとタスクのステータスは互いに独立しています。すべてのタスクが完了してもトピックは自動的に completed にならず、トピックのステータスを変更しても中のタスクが一括変更されることはありません。

トピックの説明と実行コンテキスト

エージェントがトピック内のタスクを実行するとき、トピックの名前と説明がその実行のコンテキストに追加されます。説明には、関連するすべての実行に必要な情報 — 目標、技術的な境界、成果物の取り決め — を書きます。1 件のタスクにだけ関係する要件は、そのタスクに書いてください。

リソースの追加

トピックリソースは、どのコードとどの作業ディレクトリを使うかをエージェントに伝えます。

• GitHub リポジトリ: ランタイムが checkout できるリポジトリと、任意の ref を指定します。
• ローカルディレクトリ: 特定のコンピュータ上のランタイムを既存のディレクトリで作業させます。ディレクトリの内容はエージェントが直接変更します。

選び方と安全上の境界はトピックリソースを参照してください。

トピックリード

リードはメンバーまたはエージェントで、トピックの調整役を示します。権限設定ではないため、トピック内のタスクが自動的に割り当てられることはなく、エージェントをリードにしても自動的に実行されることはありません。実行を開始するには、これまでどおりタスクの割り当て、@メンション、またはオートパイロットのトリガーが必要です。

サイドバーへのピン留め

ピン留めすると、トピックが自分のサイドバーに表示されます。ピン留めは個人の設定で、ほかのメンバーには影響しません。

作成、編集、削除

トピックの作成と編集はワークスペースのメンバーなら誰でもできます。削除できるのは owner と admin だけです。

次のステップ

• トピックリソース — GitHub リポジトリまたはローカルディレクトリを紐づけます。
• タスク — トピック内の具体的な作業を作成・整理します。
• エージェント — エージェントのアイデンティティ、設定、Access を理解します。