mcpField
C
chief-loop

chief-loop

github.com/thaitypeエージェントワークフロー6641 回インストール5 週間前に更新
リポジトリ

chief-loop について

chief-loopは、目標と契約が満たされるまでchief-agentでマイルストーンを進める自動モードのスキルです。3~5件ずつタスクを処理し、実装をbuilder-agentに委任して、各タスクの判断を個別に記録します。

主な機能

  1. 01タスクバッチによるマイルストーン進行
  2. 02builder-agentへの実装委任
  3. 03目標と契約の達成確認
  4. 04タスクごとの判断レポート
  5. 05選択肢の提示による曖昧さへの対応

活用シーン

  1. 01連続するタスクバッチでマイルストーンを進行
  2. 02各タスクの結果と判断を記録
  3. 03人への確認で停止せずタスクの曖昧さに対応

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/thaitype/chief --skill chief-loop

インストール後、Claude Code で/chief-loopを入力して読み込まれたか確認します。

詳細

目標と契約の両方が満たされるまで、バッチを重ねながらマイルストーン全体で chief-agent を実行し、バッチごとにレポートを1つまとめるのではなく、各タスクについて判断の経緯を記録したレポートを作成します。

これは chief-autopilot の自動モードを直接拡張したものです。「曖昧な点があれば停止して人間に確認する」動作を希望する場合は、代わりに chief-autopilot safe を使用してください。chief-loop は自動モードでのみ実行され、安全モードに相当するものはありません。

前提条件の確認

作業を始める前に、次のことを確認します。

  1. .chief/ 配下でアクティブなマイルストーンディレクトリを特定します。
  2. _goal/ に空でないファイルが少なくとも1つあることを確認します。
  3. _contract/ に空でないファイルが少なくとも1つあることを確認します。

いずれかが存在しない場合 → 停止します。ユーザーに次のように伝えます。

"chief-loop の実行には目標と契約が必要です。まず /chief-plan を実行してください。"

続行してはいけません。

開始前の確認

現在の目標と契約を簡潔にまとめてユーザーに提示します(ファイル名と、それぞれの1行の説明)。

次の質問を1つします。

"目標と契約はこれで正しいですか?chief-loop を実行しますか?それとも、先に /chief-plan を使って修正しますか?"

ユーザーが修正すると答えた場合 → 停止します。 ユーザーが続行を確認した場合 → 続行します。

任意: loop-readiness スキルを利用できる場合は、続行する前に、このマイルストーンの計画に対して実行するかどうかを提案します。このスキルは、計画に無人で安全に実行するためのフィードフォワード/フィードバックのカバレッジが十分にあるかを確認します。計画が依存する既存のゲートがあると指摘された場合は、それらを実際に実行して引き続き合格することを確認する loop-preflight も提案します。どちらも提案であり、必須ではありません。ユーザーが辞退した場合は、それらを実行せずに続行します。

外側のループ(必要な数のバッチを実行)

1. TODO の作成または更新

既存の _plan/_todo.md があれば読み込みます。目標、契約、完了済みの作業に基づいて、次のバッチとして3〜5個のタスクを作成します。chief-autopilot と同じ、小さなバッチで進める原則を守ります。

_plan/_todo.md に書き込みます。承認を待ってはいけません。これはオートパイロット形式であり、計画レビューのために一時停止しません。

2. バッチ内の作業をタスクごとに進める

現在のバッチにある未完了のタスクごとに、次の手順を実行します。

  1. 次の情報を添えて builder-agent に委任します。
    • TODO の項目
    • マイルストーンの目標(_goal/)
    • マイルストーンの契約(_contract/)
    • 関連する全体ルール(.chief/_rules/)
    • 検証時の要件
  2. builder の完了を待ちます。
  3. builder が阻害要因または曖昧さを報告した場合は、次に進む前に、以下の曖昧さへの対応を確認します。
  4. _todo.md でタスクを [x] にします。
  5. そのタスクのレポートを作成します(以下のタスクレポートを参照)。これは、次のタスクを始める前に直ちに行います。レポートの作成をバッチの最後までまとめて先送りしてはいけません。
3. マイルストーンの完了を確認

バッチの作業がすべて完了したら、次のようにします。

  • 目標がすべて達成されていない場合、または実装がまだ契約を満たしていない場合 → 手順1に戻り、次のバッチを作成します。
  • 目標と契約の両方が満たされている場合 → 停止します。マイルストーンは完了です。

バッチ数に上限はありません。両方の条件が満たされるまで続けます。

曖昧さへの対応

builder-agent がタスクの阻害要因または曖昧さを報告した場合:

  1. 使い捨てエージェント(永続的なエージェントタイプではなく、通常の Agent ツール呼び出し)を起動し、自己完結したプロンプトを渡します。曖昧な点、把握している選択肢を説明し、それぞれ1行のトレードオフを添えた具体的な選択肢を2〜3個提案するよう依頼します。このエージェントの役割は選択肢の検討を支援することだけです。判断を下したり、ファイルを書き込んだりしてはいけません。
  2. chief-agent が提案された選択肢を確認し、自ら1つを選択します。chief-autopilot と同様、常に chief-agent が最終決定者です。
  3. 問題点、検討した選択肢、選択した内容とその理由を、そのタスクのレポートに記録します(以下を参照)。

タスクに曖昧さがない場合は、このセクション全体を省略します。エージェントは起動せず、タスクのレポートは簡潔で事実に基づく要約のみとします。

タスクレポート

曖昧さのあるタスクだけでなく、すべてのタスクについて、次のファイルを作成します。

.chief/<milestone>/_report/task-<task-id>-report.md

<task-id>には、_plan/task-<task-id>.mdと同じ値を使用し、2つのファイルが1対1で対応するようにします。

# Task <task-id> Report

## Task
One or two lines on what this task was.

## Outcome
done | blocked

## Decision
(Omit this whole section if the task had no ambiguity.)
- **Issue:** what was ambiguous or blocking
- **Options considered:** the options the decision-support agent proposed
- **Chosen:** which one, and why

## Notes
Anything worth carrying into the next task or batch.

ルール

  • 目標とコントラクトが存在しない状態で、絶対に開始しないでください。
  • エントリー確認を絶対に省略しないでください。
  • 曖昧さについて人間からの入力を待つために、絶対に停止しないでください。このスキルの動作は、オートモードのようなものに限られます。確認のために停止したい場合は、ユーザーに chief-autopilot safe を案内してください。
  • 曖昧さについて最終決定を下すのは、常に chief-agent です。意思決定支援エージェントは選択肢を提案するだけで、決定もファイルの作成も行いません。
  • すべてのタスクについて、完了後すぐにレポートを作成してください。レポートの作成をまとめて後回しにしてはいけません。
  • 小さなバッチの原則(TODO サイクルあたり3~5タスク)を守ってください。変更されたのはレポートの粒度だけであり、計画のペースではありません。
  • マイルストーンの完了には、目標の達成とコントラクトの充足の両方が必要です。目標を達成しただけでは、停止できません。
  • すべての実装は Builder-agent が担当します。Chief は絶対にコードを書きません。
  • ユーザーが明示的に依頼しない限り、Tester-agent は使用しません。

コメント