Auto-Run Modeでは、プランを承認した後にdroidにどの程度の自律性を与えるかを決めることができます。すべてのツール呼び出しを確認する代わりに、快適に感じるリスクレベルを選択すれば、droidが行うすべての作業を表示しながら継続して動作します。Documentation Index
Fetch the complete documentation index at: https://factory-docs-auto-sync-jp-docs.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
設定可能な自律性
目の前の作業の種類に応じて、低・中・高を切り替えます。
リスクを考慮した実行
コマンドは、リスク評価が選択したレベル以下の場合にのみ自動実行されます。
予期しない動作を防ぐ
危険なコマンドやコマンド置換には常に明示的な承認が必要です。
永続的な設定
自律性レベルは設定に保存され、次のセッションで復元されます。
自律性レベルの概要
| レベル | 自動実行される内容 | 典型的な例 |
|---|---|---|
| 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 (許可されている場合), マイグレーション, カスタムスクリプト |
リスク分類
CLIを通じて送信されるすべてのコマンドには、簡潔な理由とともにリスク評価(low、medium、またはhigh)が含まれます。Auto-Runは、その評価を選択した自律性レベルと比較します:
- Low risk – 読み取り専用の操作や、不可逆的な損害を与えることができない変更(ファイル一覧表示、ログ表示、git diff)。
- Medium risk – ワークスペースを変更するが、元に戻すのが簡単なアクション(パッケージインストール、ファイル移動、ローカルgit操作、ビルド)。
- High risk – 破壊的、ロールバックが困難、またはセキュリティに敏感なコマンド(sudo、ディレクトリの削除、デプロイ、リモートスクリプトのパイプ)。
Auto-Runが実行内容を決定する方法
- ファイルツール(
Create、Edit、MultiEdit、ApplyPatch)は低リスクとして扱われ、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) – 迅速なファイル更新と調査まだプロンプトが表示される場合
- コマンドが現在の自律性レベルを上回る評価を受けている。
- CLIがコマンド置換または危険なパターンを検出した。
- ツールがセッション許可リスト外の何かを要求し、Auto(Low)モードにいる。
- Droidが明確化を必要とし(例:コンテキストの欠如、曖昧な編集)、入力を求めている。
- Escで手動で中断した(1回タップで操作を中断、2回タップで現在の入力をクリア)。
ベストプラクティス
- 新しい作業や重要な作業は、プランを信頼するまでNormalまたはAuto(Low)で開始する。
- パッケージマネージャーやビルドステップに依存する日常的な機能開発とリファクタリングにはAuto(Medium)を使用する。
- droidがエンドツーエンドスクリプトを実行することが期待される、よく理解されたパイプラインにはAuto(High)を予約する。
- 疑わしいコマンドを発見した場合は、中断し、ガイダンスを提供し、残りのリスクに適した自律性レベルで再開する。
