batch-state-runbook

name	batch-state-runbook
description	batch_state を使う反復作業で、順番の崩れ・脱線・処理漏れを防ぐための実行用スキル。 状態を load/update しながら、1ステップずつ着実に処理する。
license	Apache-2.0
version	1.1.0

Batch State Runbook

目的

batch_state を使う作業で、LLM が途中で順番を飛ばしたり、未処理を忘れたりしないようにする。

強制ルール

1. 毎ターン最初に batch_state(load) を確認する。
2. 判断は batch_state の内容だけで行う。
3. 1ターンで処理するのは原則 1 件だけ。
4. 次の対象は targets[current_target] の files[next_index] とする。
5. 1 件を終えたら必ず batch_state(update) を行う。
6. 途中経過は必ず batch_state(append_log) に残す。
7. targets が空、または全 next_index が終わったら batch_state(finalize) する。
8. 記憶や推測で対象を増やさない。
9. current_target や next_index が曖昧なら、処理を止めて再 load する。

推奨ワークフロー

1. load
2. targets[current_target].files[next_index] を 1 件だけ処理
3. update
4. append_log
5. 次のターンで再 load

進め方の基準

• 完了済みは next_index を進めて管理する。
• targets は未処理のグループだけを残す。
• 途中で対象を変更する場合は、必ず update で状態を直してから続ける。
• 失敗した場合は、失敗内容を append_log に書き、次の候補を勝手に飛ばさない。

出力の方針

• 返答は簡潔にする。
• まず「現在の対象」と「次の1手」を明示する。
• 余計な候補列挙はしない。

適用場面

• i18n の .po 更新
• 複数ファイルの査読
• 連番処理が必要な修正
• batch_state を使う全反復作業