概要
Plan を使用すると、Qoder はコードの変更を開始する前に、読み取り専用でコードを探索し、問題を分析して解決策を提示します。解決策を確認した後、Plan を終了して実際の変更を開始します。これは、影響範囲が大きい場合、複数のファイルに関わる場合、または変更前に全体的なアプローチを確認したいタスクに適しています。
Plan は独立した作業状態であり、権限ポリシーではありません。任意の権限モードと共存できます。Plan に入ると、Qoder の書き込みは制限され、主に解決策の提示に集中します。
開始と終了
/plan コマンドを使用して、Plan の開始と終了を切り替えます。
- 開始後、Qoder は読み取り専用でコードを探索して解決策を出力し、コードを直接変更することはありません。
- 終了するには、
/planを再度実行します。
--permission-mode plan は、古い使用方法との互換性のために保持されています。Plan は権限モードではなく作業状態であるため、この値は「デフォルト権限モード + Plan 状態への移行」にマッピングされます。
開始・終了時の確認
Qoder 自身が Plan の開始または終了を要求する場合、必ず先に確認を求めます。これは YOLO と Auto を含む、すべての権限モードで同様です。計画を承認するかどうかはセッションをどう進めるかという判断であり、権限モードがあなたの代わりに判断できるリスクではありません。終了時のダイアログは、計画そのものが受け入れられる場所です。あなた自身が /plan で切り替える場合、確認は不要です。
YOLO や Auto のセッションで Plan に中断されたくない場合は、settings で Plan 全体を無効化できます。
/plan と --permission-mode plan の両方が拒否されます。
仕組み
Plan 状態では：
- Qoder は関連ファイルを読み取り、コードを検索し、現状を分析して、何をどのように行うかを明確にします。
- 書き込みは制限され、レビュー可能な解決策の作成に集中します。
- 解決策に対して修正意見を提示し、期待に沿うまで Qoder に調整させることができます。
Goal との連携
Plan は Goal と組み合わせて使用されることが多いです。まず Plan で解決策を確認し、Plan を終了した後に /goal set を使用して Goal に入り、Qoder に既定の解決策に従って完了まで自律的に実行させます。これにより、方向性の正しさを保証しつつ、後続の実装作業を Qoder に任せることができます。
Goal の詳細については、目標の継続的な達成（Goal） を参照してください。Goal の実行前に Plan がアクティブな場合、Qoder はプロセス間で目標を再開する際に Plan 状態も併せて復元します。
使用タイミング
- 影響範囲が大きい変更：複数のファイルにまたがる、またはパブリックインターフェースやコアロジックに関わる修正。
- 方向性が不確定：複数の実装案が存在し、比較検討してから決定する必要がある場合。
- 事前にレビューしたい：変更前に Qoder の実行計画を確認したい場合。
関連項目
- Plan と権限モードの関係については、権限 を参照してください。
- 異なる作業方法の選択については、適切な作業方法の選択 を参照してください。