> ## 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 修正提案を手順書に適用します。

## 概要

`fix-runbook` コマンドは自動修復の診断レポートを読み込み、AI が生成した修正提案を手順書に適用します。各提案は適用前にレビューできます。

## 前提条件

* 自動修復の診断レポート（`--self-heal` で生成）
* 自動修復時に使用したオリジナルの手順書

## ワークフロー

<Steps>
  <Step title="自動修復レポートを生成">
    手順書を `--self-heal` で実行し、診断レポートを生成します：

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

    レポートは `{手順書名}-report.md`（例：`login-flow-report.md`）として保存されます。
  </Step>

  <Step title="fix-runbook を実行">
    ```bash theme={null}
    npx @refrainai/cli fix-runbook -- \
      --runbook ./login-flow.yaml \
      --report ./login-flow-report.md
    ```
  </Step>

  <Step title="各提案をレビュー">
    AI の各提案について、コマンドは以下を表示します：

    * エラーとその分類カテゴリ
    * 提案される修正（セレクタ変更、ステップ変更など）

    各提案に対して選択：

    * **適用** — パッチを生成し差分をプレビュー
    * **スキップ** — 次の提案に移動
    * **中止** — 残りの提案の処理を停止
  </Step>

  <Step title="修正後の手順書を検証">
    修正適用後、通常実行で動作を確認します：

    ```bash theme={null}
    npx @refrainai/cli execute -- \
      --runbook ./login-flow.yaml \
      --context ./context.md \
      --headless false
    ```
  </Step>
</Steps>

## CLI リファレンス

| 引数                            |  必須 | 説明                                       |
| ----------------------------- | :-: | ---------------------------------------- |
| `--runbook <path>`            | Yes | 修正する手順書のパス                               |
| `--report <path>`             | Yes | 自動修復レポートのパス                              |
| `--model <id>`                |  No | パッチ生成用 AI モデル（デフォルト：`claude-sonnet-4-6`） |
| `--model-provider <provider>` |  No | AI プロバイダー（デフォルト：`anthropic`）             |
| `--locale <code>`             |  No | UI 言語：`en` または `ja`                      |

## 次のステップ

<CardGroup cols={2}>
  <Card title="自動修復モード" icon="wrench" href="/ja/guides/self-heal">
    診断レポートの生成方法。
  </Card>

  <Card title="エラー分類" icon="triangle-exclamation" href="/ja/concepts/error-classification">
    失敗がどのようにカテゴリ分類されるか。
  </Card>
</CardGroup>