Workspaces
複数のプロジェクトを1つの名前付きプロダクトにまとめます。共有メンション、プロジェクト横断のタスクビュー、Team Map のフィルターが使えます。
プロダクトが1つのリポジトリで完結することはまれです。Web アプリ、API、モバイルクライアントは、サイドバー上では3つのプロジェクトですが、頭の中では1つのものです。Workspaces はこの結びつきを実際の仕組みにします。リポジトリの集まりが、場当たり的なリンクの寄せ集めではなく、運用上のひとまとまりになります。
作成する
方法は2つあります。
- Settings → Workspaces → Create workspace
- プロジェクトサイドバーのグループを右クリック → Create workspace…
保存する前に、実際に解決されるプロジェクトがアバター、色、絵文字つきでシートに表示されます。グループが想定どおりに展開されず、空の workspace ができあがることはありません。
メンバーシップの扱い方は2通りあります。
- サイドバーのグループに追従する — グループの変更に合わせて workspace も変わります
- スナップショット — 現時点のメンバーで固定されます
Free プランでは、workspace に含められるプロジェクトは1つだけです。保存時にエラーになるのではなく、シート上でその旨が表示されます。
他のプロジェクトをメンションする
Agent Input の @ ピッカーには Projects タブがあります。1DevTool 1.79.0 以降は、workspace のメンバーだけでなく、すべてのプロジェクトとサイドバーのグループが一覧に表示されます。それでも workspace は役に立ちます。
@Acme(workspace そのもの)は、entire workspace と表示された1行として一覧の先頭に出ます。送信時にメンバープロジェクトごとのブロックに展開されます。プロジェクトごとにサイズの上限があり、リポジトリが収まらない場合は、切り詰めたことを示す行が正直に表示されます。@Backendは、いま使っているターミナルを離れずに、そのプロジェクトのコンテキストをプロンプトに挿入します。- 他のプロジェクトを1つだけメンションすると、ファイル検索の対象がそのプロジェクトのルートに切り替わるため、
@によるファイルメンションもリポジトリの境界を越えて使えます。
サイドバーのグループ全体をメンションする方法は、プロジェクトまたはグループをメンションするを参照してください。
Terminals タブでは workspace のメンバーが先頭に表示されます。多くの場合、目的のターミナルは隣接するリポジトリのものだからです。
エージェントはプロダクト全体にアクセスできる
すでに許可したリンクを通じて、エージェントは workspace の名簿を一覧表示したり、別のプロジェクトのピアにメッセージを送ったり、全員にブロードキャストしたり、複数のターミナルから返信をまとめて収集したりできます。権限モデルは変わりません。詳しくは Read Permissions を参照してください。
workspace 全体のタスク
Tasks ボードに Workspace ビューが加わり、メンバープロジェクト全体のタスクがすべて一覧で表示されます。また、割り当てダイアログには、隣接するプロジェクトのターミナルが project · workspace の形でグループ化されて表示されます。フロントエンドのボードから API エージェントにタスクを渡すときも、プロジェクトを切り替える必要はなく、ダイアログ1つで済みます。
workspace が表示される場所
- Mission Control のカードには workspace バッジが付きます。workspace のメンバーが増減したときも、その旨が表示されます。
- Team Map には workspace チップと、その外側のすべてを表示する Show outside トグルが加わります。
- すでに持っているフォルダの追加は、追加する前に検出されます。Add Project ダイアログは、そのフォルダがすでにプロジェクトになっている場合に警告し、どのプロジェクトかを示したうえで、作業ディレクトリを共有する2つ目のエントリを作る代わりに、既存のプロジェクトを開くよう提案します。
Related
- Projects Sidebar — workspace が追従できるグループ
- Multi-Repo Workspaces — 1つのプロジェクト内に複数のリポジトリを置く機能で、これとは別のものです
- Team Map