メインコンテンツへスキップ
Auto-Run Modeでは、プランを承認した後にdroidにどの程度の自律性を与えるかを決めることができます。すべてのツール呼び出しを確認する代わりに、快適に感じるリスクレベルを選択すれば、droidが行うすべての作業を表示しながら継続して動作します。

Configurable Autonomy

Switch between Low, Medium, and High depending on the type of work in front of you.

Risk-Aware Execution

Commands run automatically only when their risk rating is at or below your chosen level.

No Surprises

Dangerous commands and command substitutions always require an explicit approval.

Persistent Preference

Your autonomy level is saved in settings and restored for the next session.

自律性レベルの概要

レベル自動実行される内容典型的な例
Auto (Low)ファイル編集、ファイル作成、組み込み許可リストからの読み取り専用コマンドEdit, Create, ls, git status, rg
Auto (Medium)Lowのすべてに加えて、ワークスペースを変更する可逆的なコマンドnpm install, pip install, git commit, mv, cp, ビルドツール
Auto (High)安全上の理由で明示的にブロックされていないすべてのコマンドdocker compose up, git push (許可されている場合), マイグレーション, カスタムスクリプト
Auto-Runは、自律性レベルに関係なく、常にストリーミング出力を表示し、すべてのファイル変更をハイライト表示します。

リスク分類

CLIを通じて送信されるすべてのコマンドには、簡潔な理由とともにリスク評価(lowmedium、またはhigh)が含まれます。Auto-Runは、その評価を選択した自律性レベルと比較します:
  • Low risk – 読み取り専用の操作や、不可逆的な損害を与えることができない変更(ファイル一覧表示、ログ表示、git diff)。
  • Medium risk – ワークスペースを変更するが、元に戻すのが簡単なアクション(パッケージインストール、ファイル移動、ローカルgit操作、ビルド)。
  • High risk – 破壊的、ロールバックが困難、またはセキュリティに敏感なコマンド(sudo、ディレクトリの削除、デプロイ、リモートスクリプトのパイプ)。
コマンドは、そのリスクレベルが現在の設定以下の場合にのみ自動実行されます。ツールがしきい値を超えるコマンドにラベルを付けた場合、CLIは一時停止して確認を求めます。

Auto-Runが実行内容を決定する方法

  • ファイルツールCreateEditMultiEditApplyPatch)は低リスクとして扱われ、Auto-Runがアクティブな場合は即座に実行されます。
  • 実行コマンドはリスクしきい値に従います。Low自律性は読み取り専用の許可リストコマンドのみを自動承認します。Mediumは可逆的なコマンドを追加します。Highは宣言されたリスクレベルを持つ任意のコマンドを受け入れますが、以下でブロックされたものは除きます。
  • 安全インターロックは、Auto(High)でも常に確認をトリガーします:危険なパターン(rm -rf /dd of=/dev/*など)、コマンド置換($(...)、バッククォート)、またはCLIセキュリティチェックで明示的にフラグされたもの。
  • 許可リスト拡張 – コマンドを承認する際に、セッション許可リストに追加して、今後の発生時に再度プロンプトが表示されないようにできます。

モードの有効化と切り替え

  • キーボードから切り替えShift+Tab(WindowsではCtrl+T)を押して、Normal → Spec → Auto(Low)→ Auto(Medium)→ Auto(High)→ Normalに戻る順で移動します。アクティブなモードはステータスバナーとヘルプポップアップに表示されます。
  • 設定でデフォルトを設定 – CLI設定メニューを開き、希望する自律性レベルを選択すると、CLIが将来のセッション用に保持します。
  • 仕様の後に選択 – Specification Modeプランを承認する際に、「進行」(手動)を選択するか、実装フェーズでAuto-RunをLow、Medium、またはHighで有効にします。
  • いつでもNormalに戻すことで手動制御に戻ることができ、droidは各ファイル変更とコマンドを再び確認するようになります。

ワークフローの例

Auto(Low) – 迅速なファイル更新と調査
- Update docs/README.md with new instructions
- Run ls, git status, and rg searches as needed
すべての編集と読み取り専用チェックはプロンプトなしで実行され、依存関係を変更するものは最初に確認を求めます。 Auto(Medium) – ツールが必要な機能作業
- Add a new React component (multiple file edits)
- npm install @acme/widget
- npm run lint
ファイル変更、依存関係のインストール、ビルドスクリプトは、可逆的である限り自動的に実行されます。 Auto(High) – マイグレーションまたは統合テスト
- Run database migration script
- docker compose up test-environment
- git push origin feature/autonomy-docs
明らかに危険なコマンドをブロックしながら、droidは一時停止なしで全体のシーケンスを実行します。

まだプロンプトが表示される場合

  • コマンドが現在の自律性レベルを上回る評価を受けている。
  • CLIがコマンド置換または危険なパターンを検出した。
  • ツールがセッション許可リスト外の何かを要求し、Auto(Low)モードにいる。
  • Droidが明確化を必要とし(例:コンテキストの欠如、曖昧な編集)、入力を求めている。
  • Escで手動で中断した(1回タップで操作を中断、2回タップで現在の入力をクリア)。

ベストプラクティス

  • 新しい作業や重要な作業は、プランを信頼するまでNormalまたはAuto(Low)で開始する。
  • パッケージマネージャーやビルドステップに依存する日常的な機能開発とリファクタリングにはAuto(Medium)を使用する。
  • droidがエンドツーエンドスクリプトを実行することが期待される、よく理解されたパイプラインにはAuto(High)を予約する。
  • 疑わしいコマンドを発見した場合は、中断し、ガイダンスを提供し、残りのリスクに適した自律性レベルで再開する。
試してみる準備はできましたか?Shift+Tabで必要なレベルに切り替えるか、次の仕様を承認する際に希望するオプションを選択してください。