概要
Goal（目標）は、Qoder CLI の自律的な実行モードです。明確な完了条件があり、達成されるまで Qoder に継続して作業させたい場合に最適です。目標を設定すると、Qoder は目標をステップに分解して実行を続け、目標が完了するかユーザーが手動で停止するまで、途中の介入を最小限に抑えます。
Goal は、「すべてのテストをパスさせる」「ビルドが通るまでリファクタリングを完了させる」「要件に従って機能を実装し、自己テストをパスさせる」といった、明確な終了点を持つタスクに適しています。
目標の設定
インタラクティブセッションで、/goal set を使用して目標を作成します。
- Qoder は目標に向けて継続して作業を開始し、必要に応じて目標を複数のステップに分解します。
- 権限モードは自動的に
autoに切り替わり、実行中の確認による中断を減らすために Shift+Tab での切り替えがロックされます。切り替え前の権限モードは記録され、目標をクリアまたは一時停止すると自動的に復元されます。 - 画面に目標のステータスインジケーターが表示されます。
最大ターン数の制限
--turns パラメータを使用して、目標実行の最大会話ターン数を制限します。上限に達すると、Qoder は停止してユーザーの指示を待ちます。
--turns の値は正の整数である必要があります。そうでない場合、このパラメータは無視されます。
目標ステータスの確認
/goal status を使用して、現在の目標の進捗を確認します。
- 目標：目標の説明。
- ステータス：Active（進行中）、Paused（一時停止）、または TurnLimited（ターン数上限到達）。
- ターン数：使用済みのターン数。上限が設定されている場合は「使用済み / 上限」として表示されます。
- 時間：目標に費やされた時間。
/goal status を実行すると、現在アクティブな目標がないことが通知されます。
目標が別のセッションによって保持されている場合はステータスにその旨が表示され、/goal take を使用して引き継ぐことができます。
一時停止と再開
他のタスクを処理するために目標を一時的に中断する必要がある場合は、/goal pause を使用して一時停止します。
/goal resume を使用して再開します。
目標の引き継ぎ
目標はセッションを跨いで永続化できます。目標が別のセッションで作成され保持されている場合、デフォルトでは現在のセッションから直接更新することはできません。/goal take を使用して、目標の所有権を現在のセッションに引き継ぎます。
目標のクリア
目標が完了した、または不要になった場合は、/goal clear を使用してクリアします。
Qoder が目標が達成されたと判断した場合、目標は自動的に完了としてマークされクリアされるため、手動でクリアする必要はありません。
Plan との連携
Goal は Plan と連携して使用できます。まず Plan で問題を分析し、アプローチを確認してから Goal に移行し、Qoder に完了まで自律的に実行させます。Goal に移行する前に Plan がアクティブな状態であった場合、Qoder は目標を再開する際に再び Plan 状態に入り、一貫した作業方法を維持します。
Plan の詳細については、先に計画してから実行する（Plan） を参照してください。
コマンド概要
| コマンド | 役割 |
|---|---|
/goal set <説明> [--turns <n>] | 目標を作成または更新し、オプションで最大ターン数を制限します |
/goal status | 現在の目標ステータスを確認します |
/goal pause | 現在の目標を一時停止します |
/goal resume | 一時停止中の目標を再開します |
/goal take | 現在のセッションに目標の所有権を引き継ぎます |
/goal clear | 現在の目標をクリアします |