メインコンテンツへスキップ

​
概要

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

​
前提条件

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

​
ワークフロー

1

自動修復レポートを生成

手順書を --self-heal で実行し、診断レポートを生成します：
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --context ./context.md \
  --self-heal
レポートは {手順書名}-report.md（例：login-flow-report.md）として保存されます。
2

fix-runbook を実行

npx @refrainai/cli fix-runbook -- \
  --runbook ./login-flow.yaml \
  --report ./login-flow-report.md
3

各提案をレビュー

AI の各提案について、コマンドは以下を表示します：
  • エラーとその分類カテゴリ
  • 提案される修正（セレクタ変更、ステップ変更など）
各提案に対して選択：
  • 適用 — パッチを生成し差分をプレビュー
  • スキップ — 次の提案に移動
  • 中止 — 残りの提案の処理を停止
4

修正後の手順書を検証

修正適用後、通常実行で動作を確認します：
npx @refrainai/cli execute -- \
  --runbook ./login-flow.yaml \
  --context ./context.md \
  --headless false

​
CLI リファレンス

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

​
次のステップ

自動修復モード

診断レポートの生成方法。

エラー分類

失敗がどのようにカテゴリ分類されるか。