Worktree
下書きの分離、基準リビジョン、OT マージと、AI SDK による編集・レビューの連携を説明します。
Worktreeは、人やエージェントが一緒に編集できるOfficeコンテンツの隔離されたドラフトを提供します。エージェントは、予算を見直し、データを再構成したり、主要な文書を編集し続けながら、簡単な書き換えを行うことができます。これはトランクと呼ばれるものです。変更がトランクに達する前に、ドラフトは検証され、レビューされます。
分離は、Git の作業ディレクトリではなく、文書の内容とその変更に適用されます。単一のタスクは、ワークブック、ドキュメント、プレゼンテーションなど、いくつかの ユニット にスパンすることができます。
分離の仕組み:共通の基準から進む
Worktreeが既存のユニット用に作成されると、ユニットの現在のトランクリビジョンがベースラインとして作成されるサービスレコード。そのリビジョンから始まり、独自のスナップショット、チェンジセット、リビジョン、プレゼンス、コラボレーションルームがあります。ドラフトで行われた編集はトランクに影響を与えません。
| 概念 | 役割 |
|---|---|
| Baseline | ドラフトが起動したトランクバージョンは、比較とマージに使用されます。 |
| Draft head | 最新確認の草案修正。 原稿の提出は、転送します。 |
| Ready head | 見直しとマージされるものを定義する凍結した草案の修正。 |
トランクとドラフトは独立して進めます。各サイドにリビジョンすると、別の投稿シーケンスが形成されますので、より高い番号はどのコンテンツが新しいかを示すものではありません。ドラフトを引っ張って、ドラフトの自身の変更を同期させます。新しいトランクの編集は、レビューの下にバージョンを入力しません。マージプレビューとマージ自体は2を再構成します。
AI SDK が同じ下書きに接続する仕組み
AI SDKのCollaboration Runtimeは1つのユニットのスナップショット、チェンジセット、リビジョンを管理します。 Server SDK側では、Worktreeサービスは作成、ライフサイクル、マージを所有しています。 ランタイムは、Worktreesで動作する2番目の編集エンジンを必要としません。
アプリケーションは、worktreeID + unitIDをドラフトのスナップショット、送信、WebSocketおよびセッションチケットURLに解決し、ランタイムにそれらを渡します。 同じ検査と編集ツールは、トランクまたはドラフトのいずれかをターゲットにすることができます。
1つのユニットIDは、トランクと複数のワークツリーに一度に存在することができます。 ターゲットには、それが住んでいるWorktreeを含める必要があります。 検査、実行、スクリーンショット、およびWebプレビューは、すべての同じターゲットを使用する必要があります。 それ以外のツールは、ドラフトから読み、トランクに書き込むことができます。 Webクライアントは、それが一致するコラボレーション構成と同じ草案をロードします。
| 担当 | 責務 |
|---|---|
| Web SDK | 共有コンテンツエンジン、ヘッドレスエージェントの操作とブラウザでの編集。 |
| Server SDK | 下書き分離、変更・版の保存、状態、OT マージ。 |
| AI SDK | 互換性のあるランタイム、検査、API のルックアップ、ファサード実行、およびビジュアルチェック。 |
| アプリケーション | モデル選択、ターゲットマッピング、アイデンティティ、権限、タスク、およびレビューUI。 |
Agent の編集から引き渡しまで
アプリケーションは、各エージェントに独自のWorktreeを与えることによって、並行してタスクを実行することができます。各エージェントは、そのドラフトを編集し、結果を確認し、それを準備します。その後、一回草案をレビューし、より多くの作業を必要とする草案を再オープンし、承認された草案を現在のトランクにマージします。
- Worktreeを作成し、それをロードします。 タスクがカバーするユニットを選択し、Worktreeターゲットを接続し、最新のコンテンツをプルします。
- 構造を点検し、必要に応じてAPIを調べ、ファサードによる変化をします。
- ドラフトに提出し、データと計算結果を読み、必要に応じてスクリーンショットをキャプチャします。 スライドは、Layout Lintを実行することもできます。 チェックが問題を報告する場合、もう一度ドラフトを編集します。
- Mark Ready. これは、各ユニットの草案の修正を凍結し、編集は、レビューが完了するまで停止します。
- レビュー。 受け入れられた草案をマージします。 人やエージェントが再び編集する前に、ドラフトに戻ります。 必要のない草案を破棄します。
| 操作 | 結果 |
|---|---|
runtime.commit() | ドラフトだけに提出し、ドラフトのリビジョンを前進させます。 |
markReady() | 何もトランクにマージすることなく、レビューバージョンを凍結します。 |
reopenWorktree() | Ready から Draft へ移行するので、編集は続行できます。 |
mergeWorktree() | 冷凍ドラフトは、ユニット単位でトランクに変化します。 |
コミット、レディ、マージは3つの別々の操作です。 ドラフトが準備完了したら、その人が、エージェントが再オープンするまで編集できるわけではありません。 ランタイムとCLIの関係については、AI SDKワークフローを参照してください。
マージ:最新 trunk に変更を適用する
トランクから来たユニットでは、サービスが準備の頭部へのベースラインから変更点を読み取り、そのミューテーションを収集し、トランクコラボレーションサービスを通じてそれらを提出します。 ベースラインが進んでいると、オタクは、サービスが新しいリビジョンを確認する前に、後でトランクの編集に対するこれらのミューテーションを変換します。
そのため、編集を適用します。最新の文書を古いスナップショットに置き換えません。変換できる同時変更は再調整されます。変換できない変更、または適用しない変更は、アプリケーションが処理する競合として返されます。 OTは、すべてのビジネスの不一致を解決しません。
Worktree内で作成されるユニットは、マージするトランクベースラインはありません。マージは、チェンジセット全体の履歴をコピーすることなくトランクで作成します。
変更内容とマージ結果を確認する
- 比較するを使用して、変更されたものを見るには、完全なベースライン状態とReadyドラフト状態を比較します。
- 特定の瞬間に何が起きるかを見るには、Ready の後の
evaluateUnitMerge()を呼び出します。トランクが進んでいると、分離されたランタイムは、現在のトランクに OT トランスフォームされた候補を適用し、読み取り専用のプレビューを生成します。それは変更を提出し、トランクやドラフトの両方を変更しません。
プレビューでは、要求される瞬間に状態を記述します。トランクは後方を変えることができ、実際のマージは実行時に見つけた状態から動作します。複数のユニットをマージすることは、原子トランザクションの1つではありません。もし1つのユニットが失敗した場合は、既にマージしているユニットはマージされ続ける。各ユニットの結果を表示し、個々の障害を処理します。
導入と対象
Worktreeクライアント、サービス、エンドポイント、データベースアダプタを連携コアと組み合わせます。ストレージを別々に保ち、セッションチケットストアをトランクで共有します。アプリケーションは、ドラフトアクセスとトランクが別々に書き込みます。分離は、それ自体でアクセスを許可しません。
シート、Doc、スライド、キャンバス、およびリレーショナルテーブルがサポートされています。 PDFは含まれていません。 例)、拡張モジュールおよびエージェントの統合ガイドは、開始点を提供します。
このガイドはいかがですか?