
Harness Loop
HAR: Codex-native long-running loop runner.
Install
npx skills add Chachamaru127/claude-code-harness --skill harness-loop -g -a claude-code -y- Repository
- Chachamaru127/claude-code-harness3.2k
- Category
- Engineering
- Updated
- 3d ago
- License
- MIT
- Context cost
- Mediumabout 1,850 tokens
- Runs scripts
- No, instructions only
What it does
HAR: Codex-native long-running loop runner. Uses a real background runner that executes one ready batch per cycle through Breezing by default, with status/stop controls. Trigger: long-running, loop, autonomous, background, Codex. Do NOT load for: one-shot implementation, normal review, release.
Harness Loop
Codex 版の harness-loop は、説明だけの擬似ループではなく、
実際にバックグラウンドで回るランナーを起動する。
ひとことで
$harness-loop は、1 回だけの実装依頼ではなく、
「今すぐ実行できる未完了タスクのまとまりを、Breezing で自動実行し続ける当番」を起動する入口。
ここでいう ready batch は、Depends が満たされていて、今すぐ並列実行できる cc:TODO / cc:WIP のまとまり。
1 cycle は 1 task ではなく、原則として 1 ready batch を処理する。
たとえると
人が横でずっと見張る代わりに、 「同時に進められる作業をまとめて見つける → Breezing に任せる → 結果を確認する → 次のまとまりへ進む」 を繰り返す監督係を、裏で常駐させるイメージ。
Quick Reference
| 入力 | 動作 |
|---|---|
$harness-loop all | 未完了タスク全体を長時間ループで開始 |
$harness-loop 41.1-41.4 | 範囲を絞って開始 |
$harness-loop JLB3R-02..JLB3R-08 | Plans.md の task ID 順で範囲を絞って開始 |
$harness-loop all --max-cycles 3 | 最大 3 サイクルで停止 |
$harness-loop all --max-workers 4 | 1 cycle の ready batch を最大 4 worker までに制限 |
$harness-loop all --max-workers max | ready batch 内で実行可能なタスク数を上限として並列化 |
$harness-loop all --plan roadmap | named Plans の roadmap を対象にループ実行 |
$harness-loop all --executor task | 旧来の 1 task per cycle local worker 実行へ逃がす |
$harness-loop all --pacing night | サイクル間の待機を長めにする |
$harness-loop status | 現在の実行状況を確認 |
$harness-loop stop | 進行中ジョブを止めてループ停止要求を出す |
実行コマンド
開始
harness codex-loop start all
範囲指定:
harness codex-loop start 41.1-41.4 --max-cycles 5 --pacing worker
harness codex-loop start JLB3R-02..JLB3R-08 --max-cycles 5 --pacing worker
harness codex-loop start all --max-workers max --pacing worker
harness codex-loop start all --plan roadmap --max-cycles 5
harness codex-loop start all --executor task --max-cycles 5
START..END は、Plans.md に並んでいる task ID をそのまま使う範囲指定。
英字やハイフンを含む task ID は .. を優先する。
41.1-41.4 のような従来の数値レンジも引き続き使える。
