Claude Code /batch + /simplify実践ガイド

Claude Codeの/batchと/simplifyは、大規模コード変更を並列エージェントで効率化するビルトインスキルだ。リファクタリングやマイグレーションでの実践的な使い方を、コマンド例とワークフローで解説する。

/batchとは｜Worktree並列オーケストレーション

/batchはClaude Codeのビルトインスキルで、git worktree上で大規模な並列コード変更をオーケストレーションする。1つのプロンプトで複数のファイル・モジュールに対する変更を同時に実行できる。

# /batchの基本的な使い方
/batch "全てのAPIエンドポイントにレート制限を追加して"

# 特定のディレクトリを対象に
/batch "src/api/ 内の全ControllerにOpenAPI docstringを追加"

/batchの動作フロー

1. 対象ファイルをスキャンし、変更が必要なファイルを特定
2. 各ファイルに対して独立したworktreeを作成
3. 並列エージェントが各worktreeで変更を実行
4. 全変更が完了後、結果をまとめてレポート
5. 変更をメインブランチにマージ可能な状態で提示

/simplifyとは｜3エージェント並列レビュー

/simplifyは変更したファイルに対して3つの並列レビューエージェントを起動し、品質チェックを行う。

# 直前の変更をレビュー
/simplify

# 特定のファイルをレビュー
/simplify src/auth/middleware.ts

3つのエージェントはそれぞれ異なる視点でレビューする。

• エージェント1: コード品質・可読性チェック
• エージェント2: バグ・エッジケース検出
• エージェント3: パフォーマンス・セキュリティ分析

実践: 大規模リファクタリング

100ファイル以上のリファクタリングを/batchで実行するワークフロー。

# Step 1: 変更計画の確認
/batch --dry-run "全てのclass componentをfunctional componentに変換"

# Step 2: 並列実行
/batch "全てのclass componentをfunctional componentに変換"

# Step 3: 品質チェック
/simplify

# Step 4: テスト実行
npm test

実践: データベースマイグレーション

ORMの変更やスキーマ更新に伴うコード修正を並列化する例。

# Prismaのスキーマ変更に伴うコード更新を並列実行
/batch "prisma schemaのUser.emailをUser.emailAddressに変更したので、
全てのファイルで参照を更新して。型定義も含めて。"

/batch + /simplifyの組み合わせ

最も効果的な使い方は、/batchで大規模変更を実行し、直後に/simplifyでレビューするパイプラインだ。

# ワンライナーパイプライン
/batch "ESLintルールをbiomeに移行" && /simplify

この組み合わせにより、従来数日かかっていた大規模リファクタリングが数時間で完了する。

注意事項とベストプラクティス

• 対象ファイル数が多い場合、APIトークン消費が大きくなる。--dry-runで事前確認を推奨
• テストスイートが整備されているプロジェクトで最も効果的
• マージコンフリクトが発生した場合は手動解決が必要

参考文献

• Extend Claude with skills – Claude Code Docs（参照日: 2026-04-07）
• Complete Claude Code Parallel Workflow Guide（参照日: 2026-04-07）
• Multi-agent orchestration for Claude Code（参照日: 2026-04-07）

この記事はAIgent Lab編集部がお届けしました。