コーディング設定
コーディングは、進行役の Coordinator LLM と、技術的な実行を担う外部 CLI Worker(OpenCode ACP)の
二層構成です。config/config.yml の coding で設定します。環境変数が設定されている場合は YAML より優先されます。
coding:
orchestrator:
provider: openai # openai | ollama | gemini | opencode_go | local
model: gpt-5.6-terra
cli:
opencode_path: /path/to/your/opencode
acp:
turn_timeout_seconds: 7200
opencode_model: opencode-go/muse-spark-1.3-contributor
opencode_models:
- opencode-go/muse-spark-1.3-contributor
| 設定 | 環境変数 | 既定 |
|---|---|---|
coding.orchestrator.provider | CODING_ORCHESTRATOR_PROVIDER | openai |
coding.orchestrator.model | CODING_ORCHESTRATOR_MODEL | gpt-5.6-terra |
coding.cli.opencode_path | CODING_OPENCODE_CLI_PATH | opencode(PATH 上) |
coding.acp.turn_timeout_seconds | CODING_ACP_TURN_TIMEOUT_SECONDS | 7200(2時間) |
coding.acp.opencode_model | CODING_OPENCODE_MODEL | opencode-go/muse-spark-1.3-contributor |
coding.acp.opencode_models | CODING_OPENCODE_MODELS(カンマ区切り) | opencode_model の 1 件 |
ターン制限時間とタイムアウト(timed_out)
coding.acp.turn_timeout_seconds(CODING_ACP_TURN_TIMEOUT_SECONDS)で ACPsession/promptの 1 ターンあたりの上限時間を秒数で設定します(既定: 7200秒=2時間)。- 制限時間は1回の ACP ターン単位に適用され、HITL ユーザー確認待機や Coordinator による次ターンでは別枠でタイマーが再開されます。
- 正の数(> 0)のみ受け付け、0以下や非数値は起動時/設定読み込み時に明示的にエラーとなります。変更の反映には Web サービスの再起動が必要です。
- ユーザーによる明示的な取り消しは
cancelling→cancelledとなり、時間上限到達時はsession/cancelを1回送信して独立した終端状態timed_outに移行します。 timed_out発生時は実行中ツール呼び出しをinterrupted(理由: 時間上限到達)に更新し、failure カテゴリの通知(「時間上限到達」)を配信します。- Task Agent の
coding_cli子 run がtimed_outとなった場合、ユーザー取消ではなく実行失敗として上位 Task に伝播します。
Coordinator の役割
- Coordinator は進捗・質問・最終要約だけを扱います。
- リポジトリ調査・実装・テスト・技術判断は Worker が担います。
- Coordinator は応答本文に
<cli_request>を出力して委譲し、アプリが Worker を実行して結果を次の観測として返します。 - Coordinator がツール経由で外部 CLI を起動することはなく、バックエンド名は開示されません。
Worker(OpenCode ACP)のモデルと reasoning effort
- Worker は
opencode acp(stdio)をサブプロセスとして起動します。起動引数はインストール済み CLI のメジャーバージョンに合わせて自動で切り替わるため、v1 系・v2 系のどちらでも設定変更は不要です。 - 使用モデルは毎ターンの prompt 前に ACP の
session/set_config_option(configId: "model")で固定されます。拒否された場合、そのターンは失敗します。 - モデルが reasoning effort(カテゴリ
thought_level)を広告する場合、max → xhigh → high → medium → lowの優先順で最初に利用できる値を同じくsession/set_config_optionで設定します。広告がない、または優先順の値がない場合は OpenCode の既定値で実行し、診断に広告値と未対応理由を記録します。設定が拒否された場合はフォールバックせず、そのターンを失敗させます。 - セッション作成時・ステータスバーで選択できるモデルは
opencode_modelsの許可リストに限られ、自由入力は拒否されます。
セッションごとのオーケストレーター LLM
- オーケストレーター(進行役)のプロバイダーとモデルは 会話設定 ⚙ ダイアログで会話ごとに変更できます。
- 未設定(「既定を使用」)の場合、そのセッションは
coding.orchestrator.provider/coding.orchestrator.modelの既定値を使用します。 - 変更は次回送信(次の run)から反映されます。実行中の run は開始時に固定した値を使い続けます。
- プロバイダーは対応するもの(
openai/gemini/ollama/local/opencode_go)から選択し、モデルは自由入力です。
バックエンド
コーディングは ACP 一本化(OpenCode のみ) です。
旧 Direct CLI(Codex / OpenCode run)と Codex バックエンドは削除済みで、
既存の Direct CLI / Codex セッションは読み取り専用です。新しい実行には OpenCode ACP の新規セッションが必要です。
トラブルシューティング
- Coordinator が応答しない / 委譲しない —
coding.orchestratorのプロバイダ・モデルと資格情報を確認します。 - Worker が起動しない —
coding.cli.opencode_pathが実行可能なopencodeを指しているか、PATH が通っているか確認します。 - 実行直後に
initializeのタイムアウトで失敗する — OpenCode CLI の更新で起動引数が変わった可能性があります。実行結果のエラーメッセージに子プロセスの終了コードと stderr(例:Unrecognized flag)が出る場合は、CLI のバージョンとopencode acp --helpの内容を確認してください。 - モデル変更が反映されない — モデル変更は 次回送信から 適用されます。また許可リスト外のモデルは拒否されます。