> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therefrain.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 手順書を実行する

> 生成された手順書を決定論的に実行します。AI コストはゼロです。

## 概要

`execute` コマンドは手順書を読み込み、各ステップをブラウザで再生します。セレクタは決定論的に解決されるため、**再実行時に AI トークンは消費されません**（フォールバック時は除く）。1 回でも 100 回でも、実行コストはゼロのままです。

## 前提条件

* 生成済みの手順書（[手順書を生成する](/ja/guides/generate-runbook)を参照）
* **AI プロバイダーの API キー**（フォールバック機能使用時のみ必要）
* **コンテキストファイル**（手順書が `context` 変数を使用する場合）

## 基本的な実行

<Steps>
  <Step title="execute コマンドを実行">
    ```bash theme={null}
    npx @refrainai/cli execute -- \
      --runbook ./login-flow.yaml \
      --context ./context.md \
      --secrets ./secrets.json \
      --headless false
    ```

    エグゼキュータの動作：

    1. 手順書を読み込み、すべての[変数](/ja/guides/variables-and-secrets)を解決
    2. ブラウザを開いて開始 URL に移動
    3. [多層的なセレクタ解決](/ja/concepts/selector-resolution)を使って各ステップを実行
    4. 各ステップの結果をレポート
  </Step>

  <Step title="変数値を入力">
    `source: prompt` の変数は CLI で対話入力を求めます。それ以外のソース（fixed、env、context、secrets）の変数は自動的に解決されます。
  </Step>

  <Step title="結果を確認">
    実行後、各ステップのステータス（成功、失敗、スキップ）を表示するサマリーが出力されます。`--report` で詳細な Markdown レポートを生成できます。
  </Step>
</Steps>

## 詳細オプション

### スクリーンショット

デバッグや監査のために、各ステップ後にスクリーンショットを保存します：

```bash theme={null}
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --screenshots ./screenshots
```

### 動画撮影

実行全体を動画として記録します：

```bash theme={null}
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --video ./recordings
```

<Note>
  動画撮影には [Business 以上](/ja/concepts/plan-tiers)のプランが必要です。
</Note>

### ダウンロードとエクスポート

ダウンロード・エクスポートファイルを特定のディレクトリに保存します：

```bash theme={null}
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --output-dir ./output \
  --merge-downloads
```

`--merge-downloads` は複数のダウンロード CSV ファイルを 1 つに結合します。

### 承認ワークフロー

`requiresConfirmation: true` が設定されたステップでは実行が一時停止し、承認を待ちます。デフォルトでは CLI で承認を処理します。チームワークフローでは Slack、Teams、Discord を使用できます。

設定の詳細は[承認と通知](/ja/guides/approval-and-notifications)を参照してください。

### ステップ遅延

ステップ間の待機時間を制御します（手順書の `pauseBetweenSteps` 設定を上書き）：

```bash theme={null}
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --step-delay 1000
```

## 実行が失敗した場合

UI の変更によりステップが失敗した場合、いくつかの選択肢があります：

1. **自動修復モード** — AI に診断と修正提案をさせる：`--self-heal`（[自動修復ガイド](/ja/guides/self-heal)を参照）
2. **ビジュアルデバッグ** — `--headless false` で失敗箇所を目視確認
3. **スクリーンショット確認** — `--screenshots` で各ステップのページ状態をキャプチャ
4. **レポート確認** — `--report` で詳細な診断情報を出力

## 次のステップ

<CardGroup cols={2}>
  <Card title="自動修復モード" icon="wrench" href="/ja/guides/self-heal">
    失敗を自動的に診断・修正。
  </Card>

  <Card title="変数とシークレット" icon="key" href="/ja/guides/variables-and-secrets">
    変数で手順書をパラメータ化。
  </Card>

  <Card title="承認と通知" icon="bell" href="/ja/guides/approval-and-notifications">
    Slack/Teams/Discord 承認の設定。
  </Card>

  <Card title="execute CLI リファレンス" icon="terminal" href="/ja/cli/execute">
    execute コマンドの全オプション。
  </Card>
</CardGroup>