> ## 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.

# fix-runbook

> AI 修正提案を手順書に適用します。

## 概要

```bash theme={null}
npx @refrainai/cli fix-runbook -- \
  --runbook <path> \
  --report <path> \
  [options]
```

実行レポート（`--self-heal` または `--report` で生成）を読み込み、AI の修正提案を抽出し、対話的に手順書 YAML に適用します。

## 必須引数

| 引数                 | 説明                     |
| ------------------ | ---------------------- |
| `--runbook <path>` | パッチ対象の手順書 YAML ファイルのパス |
| `--report <path>`  | 実行レポートのパス（Markdown）    |

## オプション引数

### AI モデル

| 引数                            | デフォルト               | 説明                       |
| ----------------------------- | ------------------- | ------------------------ |
| `--model <id>`                | `claude-sonnet-4-6` | AI モデル ID                |
| `--model-provider <provider>` | `anthropic`         | AI プロバイダー                |
| `--model-base-url <url>`      | -                   | OpenAI 互換エンドポイントのベース URL |

### 詳細設定

| 引数                | デフォルト | 説明                   |
| ----------------- | ----- | -------------------- |
| `--locale <code>` | `en`  | UI 言語: `en` または `ja` |

## 動作の仕組み

<Steps>
  <Step title="提案の抽出">
    AI がレポートを読み込み、実行可能な修正提案を抽出します。
  </Step>

  <Step title="各提案のレビュー">
    各提案について、適用・スキップ・中止を選択できます。
  </Step>

  <Step title="パッチの生成">
    AI が YAML パッチを生成し、差分プレビューを表示します。
  </Step>

  <Step title="確認と書き込み">
    確認後、パッチ済みの手順書がディスクに書き込まれます。
  </Step>
</Steps>

## 使用例

### 基本的な使い方

まず、self-heal 実行でレポートを生成します：

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

次に、修正提案を適用します：

```bash theme={null}
npx @refrainai/cli fix-runbook -- \
  --runbook ./login-flow.yaml \
  --report ./login-flow-report.md
```

## 環境変数

| 変数                  | 説明                                |
| ------------------- | --------------------------------- |
| `AI_MODEL_ID`       | `--model` のデフォルト値                 |
| `AI_MODEL_PROVIDER` | `--model-provider` のデフォルト値        |
| `REFRAIN_LOCALE`    | `--locale` のデフォルト値（`en` または `ja`） |