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つ目のエントリを作る代わりに、既存のプロジェクトを開くよう提案します。