0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

DeepSeek HarnessのAgentTeamとGit Worktreeを組み合わせて、複数エージェントの並行コード修正を回してみた

0
Posted at

DeepSeek Harness(以下DSH)でコードを書き換えていると、いつも同じ所で詰まります。1つのセッションで複数モジュールを触ると順番待ちになるし、並列化しようとセッションを2つ開くと、両方が同じ作業ディレクトリを共用するのでgit statusがぐちゃぐちゃになり、merge前に誰がどのファイルを触ったか手作業で仕分けるはめになります。そこで確かめたかったのは一点:「作業の分割」と「ファイルの隔離」を別々に解決できるか」です。

0.2.2のプレリリースには、ちょうどこの2つの半分ずつを担う実験的プラグインが入っています。バージョンを0.2.2-rc.1で固定し、専用のテストリポジトリを用意して、2つのサブエージェントに2モジュールを並行で修正させ、最初から最後まで通しで走らせました。

結論(検証日2026-11-17、バージョン0.2.2-rc.1):組み合わせ自体は成立しますが、開けたらすぐ動く代物ではありません。AgentTeamが仕事を名前付きのチームメイトに割り振り、git worktreeが各チームメイトに専用のチェックアウトディレクトリと専用ブランチを与えます。2つは自然に補完し合うのに、プレリリースでは自動では連携しない——worktreeの作成はタスク指示文に明記する必要があり、commitと後片付けは自分の仕事になります。

実行環境

  • Windows、C:とD:ドライブともにNTFS
  • DeepSeek Harness 0.2.2-rc.1(セットアップ済みの状態から開始。起動時のアップデート確認はすでにrc.3を検出しており、プレリリースチャネルの移り変わりは速い)
  • モデル:deepseek-v4-flash(Crazyrouterゲートウェイ経由)
  • テスト用リポジトリ:公開のzhouxiaoying416-sketch/dsh-agentteam-worktree-demo(相互に依存しない3モジュール、ベースラインはテスト8件全失敗)

設定ページ下部のバージョン表記0.2.2-rc.1

なぜ同じチェックアウトだと衝突するのか

これはAIの問題ではなくgitの仕組みの問題です。チェックアウトディレクトリが持てる作業ツリーの状態とインデックスは1組だけ。2つのプロセスが同じディレクトリでファイルを書き換えれば、git statusには両方の変更が混ざって表示されますし、同じファイルを触れば先に保存した側が後から保存した側に黙って上書きされます。複数エージェントで1つのチェックアウトを共用するのは、2人のエンジニアが同じマシンの同じフォルダを奪い合うのと同じ構図です。

gitはこの問題に前から答えを持っています。git worktreeなら1つのリポジトリに複数のチェックアウトディレクトリをマウントでき、それぞれ独自のブランチとインデックスを持ちます。衝突は物理的に起きなくなります。DSHのworktreeプラグインがまさにこの機構をセッションのサイドバーに持ち込むもので、AgentTeamsのドキュメントも「メンバーはチェックアウトを共用する可能性があり、独立した出力パスまたはワークツリーが依然として重要」と明言していて、辻褄が合います。

2つのプラグインの役割

  • AgentTeam(智能体团队)—誰が何をやるかを決める。 セッションがリードになり、目標を名前付きタスクに割り振り、チームメイトを立ち上げ、共有ボードで進捗を追い、チームメイト間でメッセージをやり取りさせ、最後にまとめて報告します。
  • 变更请求与工作树(Change Requests & Worktrees)—どこでやるかを決める。 サイドバーが関連PRとローカル変更を追跡し、各タスクを独立ワークツリーで隔離します。

一方が作業分配、他方がファイル隔離。どちらか片方だけでは片手落ちになります。

セットアップの3ステップ

まずプラグインを2つともオンにします。プラグインページの「実験的插件」欄にあり、デフォルトはオフです。

2つの実験的プラグインのスイッチがともにオン

次にセッションを作ってモデルを選びます。私はCrazyrouterゲートウェイ経由でdeepseek-v4-flashを使いました。プロバイダのBase URLはこの1値です:

https://api.crazyrouter.com/v1

作業前に必ず確認を。/v1/modelsへのリクエストはHTTP 200で戻り、カタログには173モデル、deepseek-v4-flashも含まれていました。モデルの利用可否を自分で確かめるならモデルカタログを、着手前にはゲートウェイのモデルカタログと課金条件に目を通してください。アクセス条件とモデルIDはこのカタログが正です。

3つ目はアクセスモードの設定で、ここが今回の実測で最初の罠でした。デフォルトの「工作区内修改」モードでは、Windows上でサンドボックスがワークスペースへの書き込み権限(ACL)の取得に失敗し、セッションが3%のまま10分以上固まりました。モデル自身は「Windowsサンドボックスの既知の問題」と診断しています。まずファイルシステムを切り分けました——C:もD:もNTFSなのでACL非対応ではありえず、詰まっているのはサンドボックスの認可ステップそのものです。「完全权限」に切り替えてダイアログを確認すると、書き込みはすべて正常化しました。代償として機微な操作の確認ステップが減るので、信頼できるタスクだけで使うべきものです。なお正直に書いておくと、セッションに送った指示文は中国語で書いたもので、リポジトリ・コード・テストは言語に依存しません。

デフォルトのアクセスモードでサンドボックスが権限取得に失敗しタスクが固まった様子

実測:チームメイト2人、ワークツリー2つ

タスクは2モジュールに限定し、ルールを最初に固定しました。

  • チームメイトAはtextutilをfeature/textutilブランチで担当
  • チームメイトBはmathutilをfeature/mathutilブランチで担当
  • 各自git worktree addで独立ワークツリーを作り、自分のファイルだけを修正
  • 相手側には触らない、mergeしない、pushしない

タスクを送ると、リードはまずリポジトリの状態を確認し、共有タスクを作り、2人のチームメイトを並行で立ち上げました。セッションヘッダにサブエージェント数(中国語UIでは「2个子智能体」=2つのサブエージェント)が表示され、サイドバーのタスクボードが動き始めます。

2つのサブエージェントが並行実行中

ワークツリーは本当に別々に作られました。git worktree listに2行増え、wt-textutilはfeature/textutil、wt-mathutilはfeature/mathutilに接続し、メインリポジトリは最初から最後までクリーンなまま。両ディレクトリを個別に確認すると、変更されているのはそれぞれ自分のソースファイルだけで交差はゼロ。それぞれの場所でnode --testを走らせると、どちらも3合格0不合格でした。

commitの段階で境界が見えました。textutil側のチームメイトは自分でcommitしました。コミット身元は自分の名前(textutil-dev、短縮ハッシュf650772)で、メッセージも整っています。一方mathutil側は修正を終え、テストに合格し、ファイルをstagedした——ところで止まりました。リードは報告待ちで固まっていて、私が並べた2件のメッセージは届きません。詰まったターンを止め、自分でwt-mathutilに入ってcommitを補いました。AgentTeamのプロトコルには「必ずgit commitまで落とす」項目がないのです。チームメイトがどこまで進むかはその子次第で、ブランチがきれいかどうかは最後に自分で検証するしかありません。

レビューは逆に一番安い工程でした。1ブランチ1コミット1ファイルなので、git show --statを一瞥するだけで済みます。私は実用的な指摘を1件出しました(clamp関数がmin > maxの逆転区間の挙動を定義していない)。wt-mathutilで修正コミットを作り、テストを再実行して3合格0不合格。

片付けはgit worktree removeで2ディレクトリを削除。ワークツリー一覧はメインリポジトリだけに戻り、2つのブランチとコミットは手つかずで残りました。メインリポジトリの8テストはまだ全滅のまま——これこそ望んだ結果で、隔離期間にmainへの漏れは一切なく、mergeのタイミングは完全に自分の手の中にあります。

自動で回るところと、自分で叩くところ

工程 実測での挙動 自動?
タスク分割、チームメイト、ボード 並行実行、ボードはリアルタイム更新 自動
ディレクトリ隔離(worktree) 各自が作成、交差ゼロ 半自動、指示文に明記して初めて作られる
テスト実行 各ワークツリーで合格するまで実行 自動
git commit 片方はcommit、片方はstagedで停止 保証されない、自分で締める
ブランチ単位のレビュー 1ブランチ1コミット1ファイルで確かに安い 形によるもので、道具によるものではない
レビュー後のブランチ更新 指摘→修正コミット→テスト再合格 手動
後片付け ブランチとコミットは残る、ワークツリーは自動削除されない 手動のgit worktree remove
Windowsの書き込み権限 デフォルトモードでACL取得失敗、完全権限なら正常 罠、手動で回避

時間の帳簿も正直に。タスク送信から両モジュールのテスト全合格まで、チームメイト2人は10分強。固まったリードのターンを含めた全体では20分超で、自分で順にやるより遅いです。並列化が買うのは処理時間ではなく見張らなくてよいことで、分割・割り当て・進捗追跡はリードの仕事、自分はレビューと締めのときだけ顔を出せばいい。モジュールがもっと増えれば、この差は自分に有利な方向に開いていきます。

よくある疑問

チームメイトがメインリポジトリを汚さないか? しません。実測を通じてメインリポジトリのgit statusはクリーン、mainは初期コミットのまま、8テストはずっと全滅を維持しました。前提は指示文に「mergeしない、pushしない」と書くことです。

チームメイトは自分でcommitするか? 名前付きのローカル身元(実測ではtextutil-devのようなローカルアドレス)でcommitすることはありますが、動作は保証されません。mathutil担当はstagedで止まりました。締めは必ず自分で。

アップグレードで設定は消えるか? 今回はアップグレードを実行していないので結論を持てません。観測できたのはアップデート確認がrc.3を提示していることと、実験的プラグインの説明に「APIはRC間で変わり得る」と明記されていること。アップグレード前にプラグイン設定のスクリーンショットを残すのが無難です。

3%で固まったら? まずアクセスモードを確認してください。デフォルトモードでのサンドボックスACL失敗は、0〜3%が長く続く形で現れます。「完全権限」に切り替えれば即回復します。その後、ドライブがNTFSか確かめてファイルシステムのACL非対応を切り分けてください。

再現に必要なもの:テストリポジトリは公開のzhouxiaoying416-sketch/dsh-agentteam-worktree-demoで、3モジュール3テストファイル、cloneするとベースラインは8テスト全滅。モデルはゲートウェイ経由でdeepseek-v4-flash、エンドポイントは/v1/chat/completions、モデルIDはゲートウェイのカタログに従います。

まとめ

この組み合わせは使い続けますが、用途は「並行マルチモジュール改造」の1場面に絞ります。単一ファイル・単一モジュールの作業なら通常セッションのほうが速くて安い。AgentTeamが担うのは仕事の割り振りと進捗管理、worktreeが担うのは物理的な衝突防止、そしてcommitの締め・レビューの反映・ワークツリーの後片付けは自分の仕事——この分担を飲み込めるかどうかが、プレリリースに手を出す価値の分かれ目です。両プラグインとも実験的で、APIはRC間で変わり得るため、本番リポジトリには安定版を待ってください。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?