Breezing — Team Execution Mode
後方互換エイリアス:
harness-workをチーム実行モードで動かします。
Quick Reference
breezing # スコープを聞いてから実行
breezing all # Plans.md 全タスクを完走
breezing 3-6 # タスク3〜6を完走
breezing --codex all # Codex CLI で全タスク完走
breezing --parallel 2 all # 2並列で全タスク完走
breezing --no-discuss all # 計画議論スキップで全タスク完走
breezing --auto-mode all # 互換な親セッションで Auto Mode rollout を試す
Options
| Option | Description | Default |
|--------|-------------|---------|
| all | 全未完了タスクを対象 | - |
| N or N-M | タスク番号/範囲指定 | - |
| --codex | Codex CLI で実装委託 | false |
| --parallel N | Implementer 並列数 | auto |
| --no-commit | 自動コミット抑制 | false |
| --no-discuss | 計画議論スキップ | false |
| --auto-mode | Auto Mode rollout を明示。親セッションの permission mode が互換な場合のみ採用を検討 | false |
Execution
このスキルは harness-work に委譲します。 以下の設定で harness-work を実行してください:
- 引数をそのまま
harness-workに渡す - チーム実行モードを強制 — Lead → Worker spawn → Reviewer spawn の三者分離
- Lead は delegate 専念 — コードを直接書かない
- Auto Mode は opt-in 扱い —
--auto-modeは互換な親セッションでの rollout 用フラグとして受け付ける
harness-work との違い
| 特徴 | harness-work | breezing (このスキル) |
|------|-----------------|------------------------|
| 並列手段 | 必要数に応じた自動分割 | Lead/Worker/Reviewer の役割分離 |
| Lead の役割 | 調整+実装 | delegate (調整専念) |
| レビュー | Lead 自己レビュー | 独立 Reviewer |
| デフォルトスコープ | 次のタスク | 全部 |
Team Composition
| Role | Agent Type | Mode | 責務 |
|------|-----------|------|------|
| Lead | (self) | - | 調整・指揮・タスク分配 |
| Worker ×N | claude-code-harness:worker | bypassPermissions(現行) / Auto Mode(follow-up)* | 実装 |
| Reviewer | claude-code-harness:reviewer | bypassPermissions(現行) / Auto Mode(follow-up)* | 独立レビュー |
*親セッションまたは frontmatter が
bypassPermissionsの場合はそちらが優先される。配布テンプレートは現在もbypassPermissionsを使うため、Auto Mode は follow-up の rollout 対象であり、既定挙動ではない。
Codex Mode (--codex)
公式プラグイン codex-plugin-cc 経由で Codex CLI にすべての実装を委託するモード:
# タスク委託(書き込み可能)
bash scripts/codex-companion.sh task --write "タスク内容"
# stdin 経由(大きなプロンプト向け)
CODEX_PROMPT=$(mktemp /tmp/codex-prompt-XXXXXX.md)
# タスク内容を書き出し
cat "$CODEX_PROMPT" | bash scripts/codex-companion.sh task --write
rm -f "$CODEX_PROMPT"
Flow Summary
breezing [scope] [--codex] [--parallel N] [--no-discuss] [--auto-mode]
│
↓ Load harness-work with team mode
│
Phase 0: Planning Discussion (--no-discuss でスキップ)
Phase A: Pre-delegate(チーム初期化)
Phase B: Delegate(Worker 実装 + Reviewer レビュー)
Phase C: Post-delegate(統合検証 + Plans.md 更新 + commit)
Progress Feed(Phase B 中の進捗通知)
Lead は Worker のタスク完了ごとに、以下のフォーマットで進捗を出力する:
📊 Progress: Task {completed}/{total} 完了 — "{task_subject}"
出力例:
📊 Progress: Task 1/5 完了 — "harness-work に失敗再チケット化を追加"
📊 Progress: Task 2/5 完了 — "harness-sync に --snapshot を追加"
📊 Progress: Task 3/5 完了 — "breezing にプログレスフィードを追加"
設計意図: breezing は長時間実行になることが多い。 ユーザーがターミナルをチラ見した時に「今どこまで進んでいるか」が一目で分かるようにする。 task-completed.sh フックが systemMessage で同等の情報を出力するため、Lead の出力と補完し合う。
Review Policy(全モード統一)
Breezing モードでもレビューは Codex exec 優先 → 内部 Reviewer フォールバック の統一ポリシーに従う。
詳細は harness-work の「レビューループ」セクションを参照。
- Worker が worktree 内で実装・commit → Lead に結果返却
- Lead が Codex exec でレビュー(120s タイムアウト、フォールバック: Reviewer agent)
- REQUEST_CHANGES → Lead が SendMessage で Worker に修正指示、Worker が amend(最大 3 回)
- APPROVE → Lead が main に cherry-pick → Plans.md を
cc:完了 [{hash}]に更新
完了報告(Phase C — Lead が生成)
全タスク完了後、Lead が以下の手順でリッチ完了報告を生成する:
git log --oneline {base_ref}..HEADで全 cherry-pick コミットを収集git diff --stat {base_ref}..HEADで全体の変更規模を取得- Plans.md の
cc:TODO/cc:WIP残タスクを抽出 harness-workの「完了報告フォーマット」の Breezing テンプレートに従い出力
生成者は Lead。Worker や hook ではない。Lead が Phase C で git + Plans.md を読んで生成する。
Phase 0: Planning Discussion(構造化 3 問チェック)
全タスク実行前に、以下の 3 問で計画の健全性を確認する。
--no-discuss 指定時は全スキップ。
Q1. スコープ確認:
「{{N}} 件のタスクを実行します。スコープは適切ですか?」
多すぎる場合は優先度(Required > Recommended > Optional)で絞り込みを提案。
Q2. 依存関係確認(Plans.md に Depends カラムがある場合のみ):
「タスク {{X}} は {{Y}} に依存しています。実行順序は合っていますか?」
Depends カラムを読み取り、依存チェーンを表示。循環依存があればエラー。
Q3. リスクフラグ([needs-spike] タスクがある場合のみ):
「タスク {{Z}} は [needs-spike] です。先に spike しますか?」
spike 未完了の [needs-spike] タスクがある場合、spike を先行実行するか確認。
3 問とも問題なければ、Phase A に進む(合計 30 秒で完了する設計)。
依存グラフに基づくタスク割り当て
Plans.md に Depends カラムがある場合(v2 フォーマット)、依存グラフに従ってタスクを実行する:
- Depends が
-のタスクを先に実行。独立タスクが複数あれば並列 spawn 可能 - 各 Worker 完了後、Lead がレビュー→cherry-pick(harness-work Phase B 参照)
- 依存元タスクが main に cherry-pick されたら、そのタスクに依存していたタスクを次に実行
- 全タスクが完了するまで繰り返す
注意: 各タスクの「Worker 完了→レビュー→cherry-pick」は逐次処理。 並列化できるのは独立タスク(Depends が
-)の Worker spawn 部分のみ。
Codex Native Orchestration
Codex では native subagent を使う。
代表的な制御面は spawn_agent, wait, send_input, resume_agent, close_agent。
Claude Code vs Codex の通信 API(SSOT:
team-composition.mdの API マッピング表):
- Claude Code:
SendMessage(to: agentId, message: "...")で Worker に修正指示- Codex:
resume_agent(agent_id)で Worker を再開 →send_input(agent_id, "...")で指示送信harness-work の擬似コードは Claude Code 構文で記述。Codex 環境では上記に読み替えること。
Related Skills
harness-work— 単一タスクからチーム実行まで(本体)harness-sync— 進捗同期harness-review— コードレビュー(breezing 内で自動起動)