batch-orchestration — скилл для Claude Code
Скилл batch-orchestration разбивает массовые однотипные изменения в коде на независимые части и запускает параллельных агентов в изолированных git worktree.
MIT ★ 2 966 обновлён 2026-09-29
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflowЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/batch-orchestration/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/batch-orchestration/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill batch-orchestration -a codex2Вручную: положить файлы
.agents/skills/batch-orchestration/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill batch-orchestration -a cursor2Вручную: положить файлы
.cursor/skills/batch-orchestration/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/pro-workflow skills/batch-orchestration2Вручную: положить файлы
.github/skills/batch-orchestration/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/pro-workflow --skill batch-orchestration -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/pro-workflow --path skills/batch-orchestrationВручную: положить файлы
.devin/skills/batch-orchestration/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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