| name | auto-fix |
| description | Codex + Claude Codeによる自動コード修正。diff→レビュー→トリアージ→修正→検証→コミットを指摘ゼロまでループ。 |
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）。
前提チェック
which codex で Codex CLI の存在を確認。なければインストール方法を案内して終了。git status でクリーンな状態か確認。未コミットの変更があれば警告。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 — バリデーション用サブエージェント
