DeepSeek Harness Job Panelの子代理分担術
📋 目次
症状：タスクは一覧で見えているのに、同じファイルを複数のサブエージェントが触り、失敗後の担当も分からない。
最速の解法：ブランド名ではなくタスク契約で分担し、入力、作業場所、権限、検収物、復旧担当を1件ずつ固定してください。
この判断は、DeepSeek Harness Job Panelを集中監視の画面として使う場合に有効です。Job Panelが見せるのはタスクの管理面であり、ファイル競合の解消、OSレベルの隔離、プロセス復旧まで自動で保証するものとは考えないでください。
この設計が必要な人
大きな作業を複数のサブエージェントへ分けたい個人開発者に向いています。
並列コード作業の書き込み範囲を管理する小規模チームや、リモート実行環境、権限、タスク復旧を担当するプラットフォームエンジニアにも役立ちます。
本稿は、DeepSeek HarnessとClaude Codeの製品選びを比較する記事ではありません。CodexやClaude Codeを含むエージェントチームで、誰が何を変更し、失敗したら誰が引き継ぐかを決めるための運用記事です。
まずはブランドではなくタスク契約で分ける
DeepSeek Harness Job Panelで最初に登録する単位は、「コードを直す」といった大きな依頼ではなく、1つの検収可能な成果物です。タスクID、目的、入力元、書き込み範囲、実行環境、検収担当、失敗時の責任者を記録します。
Codexは、公式説明では独立した環境でコードを読み書きし、テストやリンターを実行し、作業結果をログやテスト出力で確認できる構成として説明されています。Claude Codeも端末上で動く開発支援ツールですが、権限設定や実行環境によって利用できる操作は変わります。したがって、製品名から「編集に強い」「調査専用」と決めつけず、現在の接続方式で最小タスクを試してください。
- 読み取り専用の調査：リポジトリ、ログ、仕様書を読む。書き込みは禁止。
- 受動的なコード変更：指定ディレクトリだけを編集し、コミットや公開操作は行わない。
- 構築とテスト：編集済みの差分を対象に、ビルド、単体テスト、型検査を実施する。
- 外部ツール操作：Issue更新、デプロイ、秘密情報を使う処理。承認または人間の引き継ぎを必須にする。
Codexの公式タスク環境と検証可能な作業結果では、タスクごとの隔離環境と端末ログ、テスト出力の確認が説明されています。一方、DeepSeek公式のClaude Code連携資料は、連携が第三者製エージェント上で提供されることと、安全性を保証しないことを明記しています。この差を、タスク契約の設計に反映させます。
| タスク種別 | 主な入力 | 推奨する書き込み範囲 | 必須の検収物 | 失敗時の担当 |
|---|---|---|---|---|
| 読み取り調査 | 仕様書、ログ、既存コード | なし、または報告書だけ | 根拠ファイル、調査メモ、未確認点 | 主エージェント |
| 小規模修正 | 指定ファイル、再現手順 | 対象ファイルのみ | 差分、再現テスト、変更理由 | 修正担当 |
| 構築・テスト | 固定済みの差分 | 原則として書き込みなし | 実行コマンド、結果、失敗ログ | 統合担当 |
| 外部操作 | 承認済みの操作手順 | 対象サービスだけ | 操作履歴、結果、戻し方 | 人間の運用担当 |
作業場所の分離と並列数を先に決める
複数のサブエージェントが同じリポジトリを扱う場合、画面上でタスクが分かれていても、同じファイルシステムやGitブランチを共有していれば衝突します。特に、1つのエージェントがファイルを保存している途中に、別のエージェントが古い内容を読み込むと、後から保存した変更が前の差分を消すことがあります。
選択肢は3つです。
- 読み取り共有：全員が同じ作業場所を読み、書き込みは1担当に限定します。調査とレビューの組み合わせに向いています。
- 独立作業場所：エージェントごとに作業ディレクトリやブランチを分けます。変更範囲が明確で、統合担当を置ける場合に選びます。
- 順番に統合：複数の変更を同時に作らず、1件ずつ検証してから次の変更へ進みます。共有設定が不透明な場合の安全策です。
並列数を増やす前に、どのファイルを誰が所有するかを決めてください。並列化の目的が「処理時間の短縮」だけで、統合責任が決まっていないなら、直列実行の方が総時間を短くできる場合があります。競合解消、再テスト、原因調査が後から発生するためです。
Codexの作業環境については、OpenAIのCodex説明がタスク単位の独立環境を示しています。Claude Codeでは、公式チェンジログに権限確認やサブプロセス関連の変更が記載されているため、固定仕様として扱わず、利用バージョンの挙動を確認してください。
| 運用方式 | 競合リスク | 統合責任 | 向いている状況 | 編集部評価 |
|---|---|---|---|---|
| 読み取り共有 | 低 | 主エージェント | 調査、レビュー、ログ分析 | 4 / 5 |
| 独立作業場所 | 中 | 統合担当 | 独立した機能変更 | 5 / 5 |
| 同一場所で並列編集 | 高 | 不明確になりやすい | 小さな実験だけ | 1 / 5 |
| 完全な順序実行 | 低 | 依頼元または主エージェント | 共有環境、重要な変更 | 4 / 5 |
この評価は処理速度やモデル性能の実測ではなく、責任分界を作りやすいかという運用上の評価です。
権限と状態表示を別々に検証する
Job Panelでタスクの状態を確認できても、それはOSの権限境界を意味しません。次の項目を個別に確認してください。
- 読み取り可能なディレクトリと、書き込み可能なディレクトリ
- 実行可能なコマンドと、禁止するコマンド
- 外部ネットワークへの接続可否
- SSH鍵、APIキー、環境変数などの資格情報
- Gitのコミット、プッシュ、Issue更新、デプロイ権限
- 人間の承認なしに実行してよい操作
高リスク操作は、タスク契約に「承認待ち」を明記します。サブエージェントがデプロイ用コマンドを提案するところまでは自動化し、実行は人間が行う形にすると、失敗時の境界を保ちやすくなります。
DeepSeek公式のAPI更新情報では、モデルやAPIの対応範囲が更新されることが示されています。連携できることと、同じ権限で安全に実行できることは別です。接続先が変わった場合は、権限と外部操作を再確認してください。
状態についても、表示名だけで判断しないでください。実際に次の5ケースを隔離リポジトリで試します。
- タスクを作成し、タスクIDと作業場所を記録する。
- 実行中にキャンセルし、プロセスとファイル変更を確認する。
- タイムアウトを発生させ、途中成果物が残るか確認する。
- 主プロセスを終了し、タスクが本当に継続しているか確認する。
- リモート接続を切断し、再接続後にログ、プロセス、成果物を照合する。
パネルに残った表示、作業ディレクトリの差分、実行中プロセス、ログの更新時刻が一致しないなら、「継続中」ではなく「状態不明」として扱います。復旧処理を自動で再実行する前に、同じタスクが二重起動していないか確認してください。
主エージェントが引き継げる成果物を固定する
サブエージェントの回答文だけを成果物にすると、主エージェントは作業を受け取れません。最低限、次の5点を返させます。
- 変更したファイルの一覧と差分
- 実行したコマンド
- 成功したテストと、失敗したテスト
- 環境依存の注意点
- 未完了項目と推奨する次の操作
タスクIDをコミットメッセージや報告書名に含めると、同じ目的の作業が重複していないか確認しやすくなります。最終成果物の存在だけでなく、依頼時点の入力と照合し、別のサブエージェントが作った差分を誤って採用していないか確認してください。
条件分岐で実行方式を決める
- 変更範囲が1つの機能または数ファイルに収まり、検収担当が1人なら、単一サブエージェントを選びます。
- 調査、実装、テストを順番に渡せるなら、直列の複数サブエージェントにします。
- 変更対象が明確に分離され、各作業場所を分け、最後の統合担当を置けるなら、隔離並列を選びます。
- 同じファイルを複数タスクが変更する、権限継承が確認できない、復旧方法が未検証のいずれかに該当するなら、並列をやめて直列に戻します。
- デプロイ、資格情報、課金、公開リポジトリへのプッシュを含むなら、承認点を残し、サブエージェントだけで完結させません。
FAQ：Job Panelの運用で迷いやすい点
DeepSeek Harness Job Panelで子代理をどう管理するか
画面の一覧を作業台帳として使い、タスクID、所有者、作業場所、権限、検収物、復旧担当を記録します。状態表示は監視の入口であって、実際のプロセスやファイル差分の証明ではありません。
CodexとClaude Codeのサブタスクをどう分けるか
CodexとClaude Codeの名称で固定せず、読み取り、編集、テスト、外部操作の能力を小さなタスクで確認してから割り当てます。特に、モデルの接続先を変えた場合は、ファイル権限やツール利用範囲も再確認してください。
複数のサブエージェントで同じリポジトリを変更できるか
読み取りだけなら共有しやすいですが、同じファイルを同時に編集する運用は避けます。独立した作業場所に分け、1人の統合担当が差分、テスト、競合を順番に確認する構成が安全です。
サブエージェントタスクの失敗後は誰が復旧するか
タスクの依頼元である主エージェント、または明示した人間の運用担当者が判断します。再実行前に、途中のファイル変更、ログ、実行済みテスト、外部操作の有無を確認し、再実行か手動修正か破棄かを選択します。
Job Panelは再起動後もタスクを継続できるか
利用中のリリース、実行方式、ホスト構成を確認しない限り、継続を前提にしてはいけません。再起動後は、画面表示だけでなくプロセス、ログ、成果物、チェックポイントを照合し、状態が確認できなければ人間が引き継ぎます。
2つの低リスク作業で先に検証する
本番リポジトリへ大規模なタスクを投入する前に、相互に独立した低リスク作業を2つだけ実行してください。1つは読み取り専用の調査、もう1つは専用ディレクトリ内の小規模な変更にします。
確認する項目は、タスクの可視性、書き込み範囲、実行コマンド、キャンセル後の状態、失敗時のログ、成果物の受け渡しです。ここで1項目でも説明できない挙動があれば、並列数を増やさず、直列実行へ戻します。
より大きな環境で運用する場合は、Macのベアメタルと仮想化の違いを確認し、OSレベルの隔離が必要かを判断してください。複数の実行環境を持つなら、Mac計算ノードの注文方法のような容量計画も、タスク数ではなく同時書き込み数と検収待ち時間を基準に考えるべきです。
同じ共有環境でCodexとClaude Codeを動かす方法は、初期設定が簡単な反面、ファイル競合、権限の見落とし、失敗後の二重実行という弱点があります。長期間サブエージェントを並列稼働させるなら、共有ホストに無理に詰め込むより、MacDateのレンタルMacで作業場所を分け、タスクごとの権限と復旧責任を管理できる構成の方が、運用上の説明がしやすくなります。短期の検証や一時的な実行環境が必要な場合から試すのが適切です。
最初は低リスクの2タスクで契約、権限、成果物を検証し、長期運用が必要になった段階で隔離したMac環境と容量計画へ進んでください。