loop-controller-run reference
loop-controller-run は、loop-state.v1 に記録された次の Skill を評価し、許可されている場合だけ実行する入口である。既定は dry-run で、yes を付けるまで後続 Skill を起動しない。
まず何が起きるか
state=<path>を読む。state が無い場合は、指定された Issue、PR、文書から handoff state を作る。- 実行候補が1件ならその候補、複数なら
target=で選んだ候補を評価する。 - dry-run では実行予定と停止理由だけを報告する。
yesがあり、risk、確認要否、禁止操作の検査を通った候補だけを実行する。- 実行結果、または実行しなかった理由と再開方法を返す。
Options
| 指定 | 意味 |
|---|---|
state=<path> |
既存の loop-state.v1 を読む |
scope=<scope> |
state 作成に使う対象 scope |
issue=<ref> / pr-ref=<ref> / doc=<path> |
state 作成に使う対象 |
out-dir=<path> |
report、state、controller result の出力先 |
target=<workflow-id> |
workflow ID で1件選ぶ |
target=<index> |
1-based index で1件選ぶ |
target=all |
state に並んだすべての候補を評価する |
agents=codex / agents=claude / agents=copilot / agents=none |
後続 Skill に渡す local reviewer selector |
reviewers=copilot / reviewers=codex / reviewers=codex,copilot / reviewers=none |
後続 Skill に渡す GitHub reviewer selector |
dry-run |
後続 Skill を実行せず評価だけを行う。既定 |
yes |
許可された候補の実行を認める |
dry-run と yes が両方ある場合は dry-run を優先し、実行しない。agents= と reviewers= は controller 自体の reviewer ではなく、後続 Skill へ渡す指定である。
実行できる Skill
| Skill | 用途 |
|---|---|
fix-github-issue |
既存 Issue の実装 |
implement-from-plan |
local plan または文書からの実装 |
multi-review |
PR または local diff の review |
agent-team-run |
親 Issue の sub-issue queue 実行 |
どの Skill を使うかは next_invocation.skill を正本にする。controller が入力から fix-github-issue と implement-from-plan を推測したり、resume_command の文字列を解析して置き換えたりしない。
停止条件
- state を読めない、または handoff の実行範囲に反する。
- 実行候補がない、または複数候補に
target=がない。 - 指定した target が見つからない。
agents=/reviewers=のnoneとほかの値を併記している。- CLI の reviewer 指定が state の指定と衝突する。
- 許可されていない Skill や merge、auto-merge、required check bypass を要求している。
- 利用者確認が必要、または risk が高い。
yesがない、dry-run が指定されている、または現在の runtime が後続 Skill を直接起動できない。
停止時は、選択された候補、required action、次に実行できる command を報告する。現在の runtime が直接実行できない場合も、通常の逐次作業へ黙って切り替えない。
Examples
/loop-controller-run scope=issue issue=1056
/loop-controller-run state=tmp/loop/issue-1056/loop-state.json dry-run
/loop-controller-run state=tmp/loop/issue-1056/loop-state.json target=issue-1056 agents=claude reviewers=none yes
/loop-controller-run state=tmp/loop/daily/loop-state.json target=all dry-run
Related Docs
- loop-engineering reference
- loop-automation-run reference
- Issue workflow skill guide
claude/skills/loop-controller-run/SKILL.md