К основному содержанию
скилл CX Codex

batch-orchestration — скилл для Claude Code

Скилл batch-orchestration разбивает массовые однотипные изменения в коде на независимые части и запускает параллельных агентов в изолированных git worktree.

MIT ★ 2 966 обновлён 2026-09-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Открыть на GitHub

Что делает batch-orchestration

Скилл реализует команду /batch <инструкция> для масштабных механических правок, затрагивающих от 10 файлов. Оркестратор сначала сканирует репозиторий через поиск паттернов, делит задачу на 5–30 изолированных модулей и формирует план. Фоновые агенты не начнут работу без прямого подтверждения пользователя.

После одобрения плана для каждого модуля создаётся отдельный git worktree. Агент выполняет преобразование в собственном контексте, запускает локальные тесты и открывает пулреквест. В финале выводится сводка успешных и упавших задач со ссылками на PR.

Паттерн рассчитан строго на независимые задачи без общего состояния. Меньше пяти задач не окупают накладные расходы на создание worktree, а для изменений в схемах баз данных параллельный запуск приведёт к конфликтам.

Какие задачи решает

  • разбить миграцию сторонней библиотеки на параллельные изолированные задачи
  • переписать десятки компонентов по единому шаблону через git worktree
  • добавить сквозное логирование или трассировку во все обработчики API
  • покрыть тестами независимые модули без конфликтов слияния в гите

Примеры запросов агенту

  • /batch Переведи все классовые компоненты React в функциональные
  • /batch Замени moment.js на dayjs во всей кодовой базе
  • /batch Добавь обработчики ошибок во все страницы проекта

Как установить batch-orchestration

1Через маркетплейс плагинов

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

Команда ставит плагин pro-workflow целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add rohitg00/pro-workflow --skill batch-orchestration -a claude-code

3Вручную: положить файлы

~/.claude/skills/batch-orchestration/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/batch-orchestration/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о batch-orchestration

Как установить batch-orchestration в Claude Code?

Выполните последовательно команды /plugin marketplace add rohitg00/pro-workflow и /plugin install pro-workflow@pro-workflow. Также можно установить скилл командой npx skills add rohitg00/pro-workflow --skill batch-orchestration -a claude-code.

Что делает скилл batch-orchestration?

Он принимает текстовое описание однотипной правки, находит подходящие файлы в проекте и запускает параллельных агентов в отдельных git worktree для внесения изменений, прогона тестов и создания PR.

Для каких изменений batch-orchestration не подходит?

Он не подходит для правок с общим состоянием, последовательных миграций баз данных и архитектурного рефакторинга, где задачи зависят друг от друга.

Исходный текст

SKILL.md · MIT
---
name: batch-orchestration
description: Decompose large-scale changes into independent units and spawn parallel agents in isolated worktrees. Use for migrations, refactors, codemods, and any change touching 10+ files with the same pattern.
user-invocable: true
---

# Batch Orchestration

The `/batch` command pattern for large-scale parallel changes.

## How It Works

```text
/batch <instruction>
  │
  ├── 1. Research: scan repo, understand scope
  ├── 2. Decompose: split into 5-30 independent units
  ├── 3. Present plan: show units, ask for approval
  ├── 4. Execute: one background agent per unit in isolated worktree
  └── 5. Collect: each agent runs tests and opens a PR
```

## Syntax

```bash
/batch Convert all React class components to function components
/batch Add error boundaries to every page component
/batch Migrate from moment.js to dayjs across the codebase
/batch Add OpenTelemetry tracing to all API handlers
```

The instruction should describe the change pattern, not individual files. The batch system finds the files.

## Phase 1: Research

The orchestrator scans the repo to find every instance that matches the instruction:

```bash
grep -r "class.*extends.*Component" --include="*.tsx" -l
```

It builds a complete list of targets and groups them by independence.

## Phase 2: Decompose

Each unit must be:

- **Independent** — no shared state with other units
- **Self-contained** — can be implemented and tested alone
- **Verifiable** — has a clear pass/fail criteria

**Good units:**
```text
Unit 1: Convert src/components/Header.tsx (class → function)
Unit 2: Convert src/components/Footer.tsx (class → function)
Unit 3: Convert src/components/Sidebar.tsx (class → function)
```

**Bad units:**
```text
Unit 1: Convert all components in src/components/ (too broad)
Unit 2: Fix issues from Unit 1 (dependent)
```

Target 5-30 units. Fewer than 5 doesn't justify the overhead. More than 30 and coordination costs grow.

## Phase 3: Plan Approval

The orchestrator presents:

```text
BATCH: Convert class components to function components

Found: 18 class components across src/

Units (18):
  1. src/components/Header.tsx — class Header → function
  2. src/components/Footer.tsx — class Footer → function
  ...
  18. src/pages/Settings.tsx — class Settings → function

Per unit: convert class to function, update hooks, run component tests
Estimated: ~2 min per unit, ~5 min total (parallel)

Proceed? (y/n)
```

**Wait for approval.** Never spawn agents without explicit confirmation.

## Phase 4: Execute

After approval, for each unit:

1. Create isolated git worktree
2. Spawn background agent in that worktree
3. Agent implements the change
4. Agent runs relevant tests
5. Agent opens a PR

Agents run in parallel. Each has its own context window and worktree — no conflicts.

```text
[Agent 1] ── worktree-1 ── Header.tsx ── tests pass ── PR #41
[Agent 2] ── worktree-2 ── Footer.tsx ── tests pass ── PR #42
[Agent 3] ── worktree-3 ── Sidebar.tsx ── tests fail ── flagged
```

## Phase 5: Collect

After all agents complete:

- Summary of pass/fail per unit
- Links to opened PRs
- Any units that failed with error details
- Failed units can be retried individually

## Best For

| Use Case | Why Batch Works |
|----------|-----------------|
| API migrations | Same pattern across many endpoints |
| Dependency upgrades | Find/replace + fix across codebase |
| Codemod-style refactors | Mechanical transformation, file by file |
| Adding instrumentation | Same tracing/logging pattern everywhere |
| Test coverage gaps | Add tests to untested modules independently |
| Lint rule adoption | Apply new rule fixes across all files |

## Anti-Patterns

| Don't Batch | Why |
|-------------|-----|
| Interdependent changes | Units can't run in parallel if they depend on each other |
| Shared state modifications | Multiple agents writing to the same config or state file |
| Architecture changes | Need holistic reasoning, not file-by-file |
| Schema migrations | Database changes must be sequential |
| Changes requiring human judgment per file | Defeats the purpose of automation |

## Relationship to Other Patterns

| Pattern | Scale | Isolation |
|---------|-------|-----------|
| Direct edit | 1-3 files | None needed |
| Subagent | 1 focused task | Forked context |
| Worktree | 1 feature branch | Full repo copy |
| Agent teams | 3-5 parallel tasks | Shared task list |
| **Batch** | 5-30 identical pattern | Full worktree per unit |

Batch is the heaviest tool. Use it when the change is mechanical, repetitive, and the units are truly independent.

## Guardrails

- Always review the decomposition before approving
- Each agent must run tests before opening a PR
- Failed units get flagged, not silently skipped
- Clean up worktrees after all agents complete
- Review PRs in batches — don't merge blindly

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
karimo-harness-engineering-agent-orchestration opensesh Плагин karimo-harness-engineering-agent-orchestration для Claude Code ведёт фичу от PRD до мержа через субагентов и worktree. Запуск — /karimo:research. ★ 292звёзд репо implement-with-subagents chrisbanes Скилл implement-with-subagents координирует выполнение графа задач соло-агентом или пулом субагентов с изолированными коммитами и обязательным независимым ревью. CX Codex +1 807установок best-of-n-solving spencerpauly Скилл best-of-n-solving запускает 2–3 подхода к сложной задаче одновременно, каждый в своей git-ветке, и помогает выбрать лучший результат. CX Codex +1 463установок principle-build-the-lever backnotprop Скилл principle-build-the-lever для Claude Code заставляет агента писать скрипты, кодмоды или генераторы вместо ручных правок. Включается на нетривиальных задачах, миграциях и проверках кода. CX Codex +1 10 200установок troupe-mission hitianqi Скилл troupe-mission для Claude Code координирует параллельную работу субагентов в отдельных окнах tmux и ветках git. Сессия пишет план, отдаёт задачи ролям и проверяет код перед слиянием. CX Codex +1 ★ 140звёзд репо suede-graph-flo-xr JasonColapietro Скилл suede-graph-flo-xr сравнивает и отсеивает планы реализации до внесения правок в код. Запускает граф рассуждений, выбирает один вариант и тестирует сборку в изолированном дереве Git. CX Codex +1 ★ 121звёзд репо

Из того же набора83

Весь набор →
wiki-viewer Скилл wiki-viewer для Claude Code собирает вики pro-workflow в один HTML-файл: страницы, источники, утверждения, очередь сидов, граф ссылок и поиск. Позволяет передать ход исследования коллеге. CX Codex +1 ★ 2 966звёзд репо llm-council Скилл llm-council собирает консилиум из нескольких нейросетей в три этапа: параллельные ответы, анонимное взаимное ранжирование и финальный синтез ответов председателем. CX Codex +1 ★ 2 966звёзд репо design-engineering Скилл design-engineering для Claude Code — проектирует анимации и состояния интерфейса, разбирает UI-код компонентов, переходов и модальных окон. CX Codex +1 ★ 2 966звёзд репо permission-tuner Скилл permission-tuner для Claude Code анализирует запросы на разрешение и отказы автомода, генерируя правила, которые сокращают прерывания. Включайте его, если разрешения мешают работе. CX Codex +1 ★ 2 966звёзд репо insights Команда insights в Claude Code считает статистику сессий: правки файлов, самоисправления агента и сработавшие правила. Показывает повторяющиеся ошибки. CX Codex +1 ★ 2 966звёзд репо doctor Команда doctor проверяет здоровье установки pro-workflow и конфигурации Claude Code: хуки, база данных, контекст, MCP-серверы, гит-статус. Помогает отловить сломанные скрипты и конфликты настроек на ранней стадии. CX Codex +1 ★ 2 966звёзд репо thoroughness-scoring Скилл thoroughness-scoring обязывает ассистента оценивать инженерные решения по шкале от 1 до 10 и предпочитать надёжный код быстрым костылям. CX Codex +1 ★ 2 966звёзд репо skill-optimizer Скилл skill-optimizer анализирует накопленные исправления и предлагает правки для SKILL.md. Изменения проходят проверку на отложенных примерах, прежде чем попасть в файл. CX Codex +1 ★ 2 966звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой