CCH のプロンプトと担当への受渡し

CCH は、担当に目的、変更範囲、完成条件、確認済みの根拠を渡す。担当はその条件の中で方法を選ぶ。モデル名や推論量を選ぶ処理と、何を依頼するかを決める処理は別々に管理する。

プロンプトはモデルへの依頼文を指す。サブエージェントは、主担当とは別の会話で働く担当である。主担当の会話を読めるとは限らないため、タスク番号だけでは必要な情報が伝わらない。

依頼に含める情報

情報	内容	欠けると起こること
目的と理由	利用者ができるようになること、その仕事が必要な理由	目の前の関数だけ直して業務の問題が残る
担当範囲	作業場所、変更してよいファイル、他担当との境界	同じファイルを競合して編集する
完成条件	仕様、DoD（完成と判定する条件）、必要な確認方法	本人の成功宣言だけで終了する
観測した根拠	再現手順、ログ、現在の差分、既に通った検証	同じ調査を繰り返す、失敗原因を取り違える
決定と承認の参照	元の依頼、確定した制約、まだ人間の判断が要る点	要約に書かれた推定を実行許可として扱う
再修正と再開の情報	修正対象の指摘、試した方法、未完了項目、次の判断	再レビューの指摘が実装へ届かない

承認の参照が無い場合は未提供とする。計画から抽出した declared_scope は変更範囲の推定であり、利用者が許可した証拠ではない。

たとえば「注文の重複登録を直す」タスクでは、担当には対象の保存処理、重複が起きる操作、同じ注文が1件だけ保存される完成条件、既存のテスト、変更を避ける決済処理を渡す。実装の細かな順番まで主担当が固定する必要はない。ただし、TDD（先に失敗するテストを確認する開発手順）が必須のタスクでは、その順番と証跡を守る。

担当ごとの動き

担当	任せること	返すもの
Planner	依頼と仕様から、独立して検証できる作業単位を作る	担当範囲、依存関係、完成条件を含む計画
Worker	承認済みの担当範囲で実装し、必要な修正と検証を終える	差分、実行した確認、結果、残った問題
Advisor	目的と失敗の根拠を読み、次に変える判断を示す	PLAN、CORRECTION、STOP のいずれかと短い指示
Reviewer	実装担当から独立し、仕様と現在の実物を比較する	既存形式の判定と、場所を特定できる指摘
Coordinator	所有範囲と依存関係を調整し、成果を統合する	検証結果に基づく現在地と次に必要な判断

情報が足りない場合は、まず渡された契約と該当コードを読んで回収する。可逆な実装手段の選択は仮定を記録して進める。許可された範囲や重大な仕様判断が未確定なら、その処理を止める。調査だけの依頼を、勝手に実装の依頼へ変えない。

独立した作業は、同時実行の上限とファイルの所有範囲を守って委譲する。主担当も別の有用な仕事を続け、結果が必要になった時点で待つ。関連する追加作業は同じ担当を再利用できる。最終レビューは新しい会話で行う。

必要な検証は省略しない。通過後に検証を増やすのは、新しい変更、失敗、未解決の懸念がある場合である。実装を写しただけのテストや、依頼外の機能を追加して作業を広げない。報告では実行予定、実行済み、検証済みを区別する。

指示の正本と届く先

正本	届く先	扱い
skills/ の23入口と54 reference	Claude、Codex、OpenCode の skill	全体を監査し、必要な役割固有の文面を調整
skills-codex/ の3差分と4 reference	Codex の同名 skill	shared 版とは別に監査。生成時はこちらを優先
agents/worker.md、reviewer.md、advisor.md	Claude の native 担当	入力の回収、証拠、役割の境界を各担当に記載
hosts.toml	Codex の worker / reviewer profile	単独で配布されても意味が通る指示を生成
Go の promptpack/prompts/ 4本	harness plan/work/review/release	実行ファイルに埋め込む。外部ファイルの存在に依存しない
loop、advisor、Go team、browser artifact の生成処理	実際に呼び出す担当	文面に加え、具体的なタスク情報の受渡しを検証
codex/AGENTS.md、setup の EN/JA テンプレート	新しい導入先の常駐指示	設定済みの利用者ファイルを自動上書きせず、配布元を更新
output-styles/harness-ops.md	Claude の報告表示	完了と未確認を分け、判断に必要な実物を示す
livemsg-gate、test-wiring-auditor、hook の3 prompt	事実確認と既存の保護処理	一般実装担当の自律指示を混ぜず、固定された判定契約を保持

scripts/sync-skill-mirrors.sh が skill の写しを更新する。harness gen が native profile を生成する。Go の組込み指示はバイナリを再ビルドしなければ利用先に届かない。配布確認では、ソースの変更だけでなく、この3経路を照合する。

互換 helper と Cursor 固有の指示も監査対象にする。ただし、provider 固有の実行手順を Fable / astra 用に一括置換しない。既定 OFF の機能は、プロンプト調整を理由に有効化しない。

Go の HARNESS_TEAM_HIERARCHY=sublead は、内部で呼ぶ harness plan decompose が必要な JSON の小計画を返さない未対応経路である。今回、動作済みと読める文面を修正した。通常の flat（主担当が各 worker を直接管理する方式）を維持する。この入口の実装はプロンプト調整だけでは完了しない。

Go の追加レビュー HARNESS_REVIEW_ITERATE=on も、実判定に必要な claude-companion.sh が未提供である。返答形式と引継ぎは fixture（外部サービスを置き換える検証用の実装）で確認し、既定 OFF を維持する。通常の skill と native reviewer を使うレビューとは別の経路である。

この Go 追加経路では、引き継いだ過去の出力に「npm publish を実行しなかった」とあるだけでも、実行前検査が公開操作と検出して止まる。本文は単一の引数で渡しており、記述されたコマンドを shell として実行するわけではない。将来有効化する際は、検査を置き換えた配送テストに加え、実際の検査を通す統合確認が必要になる。

設定との関係

モデルは担当の能力、effort（推論量）は考える処理の割当て、プロンプトは担当の仕事を決める。目的が届かない経路は、effort を上げても修復されない。必要な情報の受渡しを先に検証する。

Fable / astra のルートと明示値の優先順位は model-routing-policy.md に従う。軽量 worker、Sonnet の隔離 reviewer、read-only の権限、レビュー上限、保護設定は維持する。文面によってモデルや権限を自動変更させない。

Codex 0.153.4 では、同じ設定階層にある agents.reviewer の宣言が、単独の reviewer.toml より優先する。既定の担当ファイルを使うには config_file で参照を結ぶ。設定ファイルの存在に加え、新しく起動した Codex が示す担当のモデルと推論量で確認する。

この版の native 子は、親の実行権限を引き継ぐ。担当ファイルの sandbox_mode=read-only だけで、ファイル変更が実行アプリに禁止されるとは扱わない。CCH の読み取り専用レビューは、その実行設定を明示する companion 経由で行う。役割への指示と実行アプリの権限は、別々に確認する。Codex の実装と検証

利用者がモデルや推論量を手動で変更することは許容する。既定値は固定の強制値ではない。現在の会話の設定、担当の設定、一回の呼出しの指定は、それぞれの実行経路で尊重する。環境更新では、調査開始時の値を現在値へ戻さず、CCH の変更対象外の最新設定を保持する。親の設定変更を全ての子に自動配布する意味ではない。

API（アプリからモデルを呼ぶ接続口）の async、WebSocket、configuration_update、thinking.display は実行アプリの対応が必要になる。プロンプトへ名前を書くだけで CLI の機能が増えるものではない。

出典と検証範囲

2026-09-05 に指定された OpenAI latest-model guide と Claude Fable 5 prompting guide を確認した。後者は Fable 5 のページとして HTTP 200 を返し、5.1 への転送ではない。Fable 5.1 の別ガイド も照合した。

公式資料の原則を、このリポジトリの契約と実装に当てはめた設計である。判断理由と検証可能な根拠を求め、内部の思考過程の逐語開示は要求しない。入力捕捉テストは情報が呼出し先へ届くことを証明する。実務の速度や正答率の改善量は、同じ条件の代表タスクを比較しなければ測れない。