Cursor での YOLO モードを使用した迅速なイテレーション

Cursor の YOLO モード（You Only Live Once）は、AI が生成したすべての diff や変更を、それぞれ手動で承認することなく自動的に受け入れます。これにより、反復的な作業や信頼できるワークフローが劇的に高速化されますが、リスクも伴います。このガイドでは、YOLO モードを安全かつ効果的に使用する方法をカバーします。

YOLO モードとは？

YOLO モードを有効にすると：

• 自動 diff 受け入れ - AI の変更が即座に適用される
• より速いイテレーション - すべての変更で「Accept」をクリックする必要がない
• バッチ操作 - 複数の変更を順番に適用
• 摩擦の低減 - フロー状態をより長く維持

YOLO モードを使用するタイミング

適切なユースケース

シナリオ	YOLO が機能する理由
JSDoc コメントの追加	リスクが低く、予測可能
変数のリネーム	検索で簡単に検証できる
コードのフォーマット	安全で、元に戻せる
型の追加	コンパイラがエラーをキャッチ
インポートのリファクタリング	IDE が問題をハイライト
テストの作成	テストランナーが検証
設定ファイルの更新	通常は単純明快

YOLO を避けるべきシナリオ

シナリオ	リスクレベル
認証の変更	重大
データベースマイグレーション	重大
支払い処理	重大
API 契約の変更	高
大規模なアーキテクチャ変更	高
本番デプロイ	重大
ファイルの削除	高

YOLO モードの有効化

方法 1: 設定

{
  "cursor.yoloMode": true,
  "cursor.autoAcceptDiffs": true,
  "cursor.autoApplyChanges": true
}

方法 2: コマンドパレット

1. Cmd/Ctrl + Shift + P を押す
2. "YOLO Mode" と入力
3. YOLO モードを切り替え を選択

方法 3: チャットコマンド

/yolo

または：

このセッションで YOLO モードを有効にする

方法 4: キーボードショートカット

// keybindings.json
{
  "key": "cmd+shift+y",
  "command": "cursor.toggleYoloMode"
}

YOLO モードの設定

安全な YOLO 設定

{
  "cursor.yoloMode": true,
  "cursor.autoAcceptDiffs": true,
  
  // 安全制限
  "cursor.yolo.maxFilesPerSession": 20,
  "cursor.yolo.maxLinesChanged": 500,
  "cursor.yolo.requireTestsPass": true,
  "cursor.yolo.excludePatterns": [
    "src/auth/**",
    "src/payment/**",
    "src/database/migrations/**",
    "**/*.env*",
    "config/production/**"
  ],
  
  // 自動保存設定
  "cursor.yolo.autoSaveBeforeApply": true,
  "cursor.yolo.createGitCheckpoint": true
}

プロジェクトごとの YOLO

.cursor/yolo-config.json を作成：

{
  "enabled": true,
  "safePatterns": [
    "src/components/**/*.tsx",
    "src/hooks/**/*.ts",
    "src/utils/**/*.ts",
    "tests/**/*.ts"
  ],
  "unsafePatterns": [
    "src/auth/**",
    "src/api/**",
    "src/database/**"
  ],
  "maxChangesPerFile": 50,
  "requireReviewFor": [
    "*.config.*",
    "*.env*",
    "Dockerfile"
  ]
}

安全な YOLO ワークフロー

ワークフロー 1: ドキュメントスプリント

[YOLO ON] src/utils/ のすべての関数に JSDoc コメントを追加
src/utils/helpers.ts の既存のスタイルに従う

期待される結果: 15-20 ファイルが変更され、すべてのコメントが追加される 検証: いくつかのファイルをスポットチェック

ワークフロー 2: TypeScript 移行

[YOLO ON] src/components/ に TypeScript の型を追加
src/types/ のインターフェースを使用
既存のランタイム動作を維持

期待される結果: 型が追加され、ロジックの変更はない 検証: tsc --noEmit を実行

ワークフロー 3: テスト生成

[YOLO ON] src/services/user.ts の単体テストを作成
tests/services/auth.test.ts のパターンに従う
すべての公開メソッドをカバー

期待される結果: 新しいテストファイルが作成される 検証: npm test でテストを実行

ワークフロー 4: インポートのクリーンアップ

[YOLO ON] src/pages/ のインポートを整理
グループ: React、外部ライブラリ、内部、型
未使用のインポートを削除

期待される結果: クリーンなインポート、機能的な変更はない 検証: アプリが依然としてビルドされる

安全対策

1. Git チェックポイント

YOLO の前に必ずチェックポイントを作成：

# YOLO チェックポイントブランチを作成
git checkout -b yolo/task-name

# 現在の状態をコミット
git add -A && git commit -m "checkpoint: before YOLO session"

2. YOLO 後のレビュー

YOLO セッション後：

# すべての変更をレビュー
git diff

# 変更されたファイルを確認
git diff --stat

# テストを実行
npm test

# 何か問題があれば元に戻す
git checkout -- .

3. テスト付き YOLO

テストが通過した場合のみ YOLO するように構成：

{
  "cursor.yolo.requireTestsPass": true,
  "cursor.yolo.testCommand": "npm test",
  "cursor.yolo.stopOnTestFailure": true
}

4. ファイルサイズ制限

{
  "cursor.yolo.maxFileSizeKB": 100,
  "cursor.yolo.maxFilesPerChange": 10,
  "cursor.yolo.maxLinesPerFile": 200
}

YOLO モードコマンド

チャットコマンド

コマンド	アクション
/yolo on	YOLO モードを有効化
/yolo off	YOLO モードを無効化
/yolo status	YOLO 状態を確認
/yolo safe	安全なパターンのみ YOLO
/yolo full	フル YOLO（すべてのファイル）

セッションコマンド

[yolo on] すべての API エンドポイントにエラーハンドリングを追加

[yolo safe] コンポーネントの props をインターフェースを使用するようにリファクタリング

[yolo off] 待って、最後の変更を先にレビューさせて

YOLO の効果測定

これらのメトリクスを追跡：

メトリクス	YOLO なし	YOLO あり
タスクあたりの時間	15-30 分	5-10 分
変更あたりのクリック数	3-5	0
コンテキストスイッチ	高	低
エラーレート	低	やや高い
リバートレート	低	5-10%

チーム YOLO ガイドライン

チームが YOLO を使用すべきタイミング

• コードスタイルの更新
• ドキュメントの改善
• 型の追加
• 内部ユーティリティのリファクタリング
• テストの作成

YOLO が禁止されているタイミング

• 本番ホットフィックス
• セキュリティ関連の変更
• データベーススキーマの変更
• API バージョンの変更
• 設定の変更

YOLO 変更用 PR テンプレート

## YOLO セッション

### タスク
[YOLO セッションが何をしたか説明]

### 変更されたファイル
- [x] すべての変更をレビュー済み
- [x] テストが通過
- [x] 機密ファイルは変更されていない

### 検証
- [x] 手動スポットチェック完了
- [x] 自動テストが通過
- [x] リグレッションは検出されない

### ロールバック
```bash
git revert HEAD

## YOLO モード + その他の機能

### YOLO + バックグラウンドエージェント

[Background, YOLO ON] src/models/ のすべてのファイルに型を追加

### YOLO + カスタムモード

```json
{
  "name": "Safe YOLO",
  "systemPrompt": "You are in YOLO mode but with safety constraints. Only modify: .tsx components, .ts utilities, and tests. Never modify: auth, payment, or database files. Always add types, never remove them.",
  "tools": {
    "write": true,
    "edit": true
  }
}

YOLO + プランモード

[PLAN MODE] リファクタリングを計画
[Review plan]
[YOLO ON] 承認された計画を実行

一般的な YOLO の落とし穴

落とし穴	防止策
間違ったファイルで YOLO	excludePatterns を使用
変更が多すぎる	maxFilesPerSession を設定
破壊的変更	テストの通過を要求
追跡を失う	Git チェックポイントを作成
セキュリティ問題	auth/payment ファイルを除外

クイック YOLO 安全チェックリスト

YOLO セッションを開始する前に：

• Git チェックポイントブランチを作成
• YOLO 設定をレビュー
• タスクが YOLO に安全であることを確認
• 機密ディレクトリを除外
• 後でテストを実行できる
• ロールバック計画が準備できている

YOLO セッション後：

• git diff で diff をレビュー
• テストを実行
• 主要ファイルをスポットチェック
• コミットまたはリバート

関連リソース

• Cursor Agent Mode Masterclass
• Plan vs Act Dual-Mode Workflow
• RIPER-5 Advanced Constraint Mode
• Cursor Self-Review Hooks Guide