auto-fix

---

name: auto-fix description: Codex + Claude Codeによる自動コード修正。diff→レビュー→トリアージ→修正→検証→コミットを指摘ゼロまでループ。 argument-hint: [--max-iterations N] [--base-branch BRANCH] allowed-tools: Bash, Read, Grep, Glob, Agent

AI Auto-Fix Workflow

「自動修正」「auto-fix」「指摘を直して」「fix」と言われたら起動する。

Codex（gpt-5.4）とClaude Codeサブエージェントを組み合わせた自動コード修正システム。 ハーネスエンジニアリングの考え方に基づき、過剰指摘のフィルタリング、オシレーション検出、テスト実行による検証を自動化する。

役割分担

• Codex (gpt-5.4): レビュー精度が高い。レビューと修正を担当。
• Claude Code subagent: シェルコマンド実行が可能。トリアージとバリデーションを担当。テスト・lint・typecheckを直接実行して検証できる。

設定の読み込み

プロジェクトルートの .auto-fix.yml を読む。なければデフォルトを使う:

max_iterations: 6
base_branch: main
test_command: npm test
lint_command: npm run lint
typecheck_command: npx tsc --noEmit
severity_threshold: IMPORTANT

引数 $ARGUMENTS があればパースしてデフォルトを上書き（例: --max-iterations 4 --base-branch develop）。

前提チェック

1. which codex で Codex CLI の存在を確認。なければインストール方法を案内して終了。
2. git status でクリーンな状態か確認。未コミットの変更があれば警告。
3. git diff --name-only $base_branch で差分があるか確認。なければ終了。

メインループ

以下を最大 max_iterations 回繰り返す。

Step 1: Review (Codex)

scripts/codex-review.sh を実行する（スキルディレクトリ内のスクリプトを使う）:

bash "${CLAUDE_SKILL_DIR}/scripts/codex-review.sh" "$base_branch"

findings が 0 件ならループ終了。

Step 2: Triage (サブエージェント)

サブエージェントを起動する。プラグインエージェント /auto-fix:triage を使う。

サブエージェントに渡す情報:

• findings.json の内容
• 過去イテレーションの commit diff（あれば）
• プロジェクトのコーディングガイドライン（あれば）

filtered_findings が 0 件ならループ終了。

Step 3: Fix (Codex)

scripts/codex-fix.sh を実行する:

bash "${CLAUDE_SKILL_DIR}/scripts/codex-fix.sh" "$filtered_findings_path" "$directives_path"

Step 4: Validate (サブエージェント)

サブエージェントを起動する。プラグインエージェント /auto-fix:validate を使う。

サブエージェントに渡す情報:

• 修正前後の git diff
• 元の filtered_findings
• directives
• test/lint/typecheck コマンド

サブエージェントが問題を検出した場合、自身で修正を行う。

Step 5: Commit

変更があればコミット:

git diff > /tmp/auto-fix/iteration-$N/commit.diff
git add -A
git commit -m "fix: auto-fix iteration $N"

Step 1 に戻る。

ループ終了後

結果サマリーを表示: 総イテレーション数、処理した findings 数、除外数、最終状態。

エラーハンドリング

• Codex CLI タイムアウト → リトライ1回、ダメならスキップして報告
• テスト失敗 → 失敗内容を findings に追加してループ継続
• サブエージェント異常終了 → そのイテレーションをスキップして次へ

バンドルされたリソース

• scripts/codex-review.sh — Codex review モード実行
• scripts/codex-fix.sh — Codex fix モード実行
• references/oscillation-patterns.md — オシレーション検出ロジック
• references/triage-examples.md — トリアージ判定の具体例

プラグインエージェント

• /auto-fix:triage — トリアージ用サブエージェント
• /auto-fix:validate — バリデーション用サブエージェント