flow-next-worktree-kit — скилл для Claude Code: git-воркдеревья
Скилл flow-next-worktree-kit для Claude Code создаёт, переключает и удаляет git worktrees, копируя .env. Ведёт параллельную работу над фичами без переключения веток.
MIT ★ 730 обновлён 2026-10-29
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-nextЧто делает flow-next-worktree-kit
Скилл управляет git worktrees через скрипт worktree.sh. Создаёт воркдерево в .worktrees/<имя>, переключает в него, выводит список или удаляет вместе с веткой.
Команда create не меняет текущую ветку и создаёт новую без upstream: первый git push требует -u origin <имя>. Команда cleanup не использует force: если воркдерево не чистое, удаление не пройдёт. Копирование .env идёт без перезаписи, симлинки пропускаются.
При параллельных агентах в разных воркдеревьях состояние claim в .git/flow-state общее: для одновременного запуска flow-пайплайнов нужен отдельный FLOW_STATE_DIR на каждого агента.
Какие задачи решает
- создать воркдерево для фичи, не переключая основную ветку
- переключиться в другое воркдерево для ревью
- удалить воркдеревья и ветки после мержа
- скопировать
.envв новое воркдерево - вывести список воркдеревьев проекта
Примеры запросов агенту
- Создай воркдерево
feature-authот веткиdevelop - Переключись в воркдерево
hotfix-login - Удали воркдеревья
old-featureиtest-branch
Как установить flow-next-worktree-kit
1Через маркетплейс плагинов
/plugin marketplace add gmickel/flow-next/plugin install flow-next@flow-nextКоманда ставит плагин flow-next целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-worktree-kit -a claude-code3Вручную: положить файлы
~/.claude/skills/flow-next-worktree-kit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/flow-next-worktree-kit/
1Через Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-worktree-kit -a codex2Вручную: положить файлы
.agents/skills/flow-next-worktree-kit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-worktree-kit -a cursor2Вручную: положить файлы
.cursor/skills/flow-next-worktree-kit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install gmickel/flow-next plugins/flow-next/skills/flow-next-worktree-kit2Вручную: положить файлы
.github/skills/flow-next-worktree-kit/SKILL.md1Через Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-worktree-kit -a gemini-cli2Командой платформы
gemini skills install https://github.com/gmickel/flow-next --path plugins/flow-next/skills/flow-next-worktree-kitВручную: положить файлы
.devin/skills/flow-next-worktree-kit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о flow-next-worktree-kit
Как установить flow-next-worktree-kit в Claude Code?
Выполни /plugin marketplace add gmickel/flow-next, затем /plugin install flow-next@flow-next, потом npx skills add gmickel/flow-next --skill flow-next-worktree-kit -a claude-code. Скилл появится в ~/.claude/skills/flow-next-worktree-kit/SKILL.md.
Что делает flow-next-worktree-kit?
Скилл создаёт, переключает и удаляет git worktrees, копирует файлы .env между ними. Это позволяет работать над несколькими фичами параллельно, не переключая ветки в основной директории.
Куда создаются воркдеревья?
Все воркдеревья размещаются в .worktrees/ корня репозитория. При первом создании скилл добавляет .worktrees/.gitignore с * и !.gitignore, чтобы git add -A не захватывал их как gitlinks.
Исходный текст
SKILL.md · MIT
---
name: flow-next-worktree-kit
description: Manage git worktrees (create/list/switch/cleanup) and copy .env files. Use for parallel feature work, isolated review, clean workspace, or when user mentions worktrees.
---
# Worktree kit
Use the manager script for all worktree actions.
```bash
WORKTREE_SH="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/flow-next-worktree-kit/scripts/worktree.sh"
[ -f "$WORKTREE_SH" ] || WORKTREE_SH="<plugin-root>/skills/flow-next-worktree-kit/scripts/worktree.sh" # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
bash "$WORKTREE_SH" <command> [args]
```
Commands:
- `create <name> [base]`
- `list`
- `switch <name>` (prints the worktree path; it cannot change your shell's directory - use `cd "$(... switch <name>)"`)
- `cleanup [<name>...] [--yes]` (no args = interactive; names skip the prompt; `--yes` skips the confirmation, required off a terminal)
- `copy-env <name>`
Safety notes:
- `create` does not change the current branch
- `create` sets no upstream on the new branch (`--no-track`) - under the upstream-based push modes (`simple`, `upstream`, `current`) a bare `git push` cannot aim at the base branch; under the default `push.default=simple` (without `push.autoSetupRemote`) the first push needs `git push -u origin <name>` (legacy `push.default=matching` pushes all name-matched branches regardless of upstream)
- `cleanup` does not force-remove worktrees and does not delete branches
- `cleanup` deletes the worktree directory (including ignored files); removal fails if the worktree is not clean
- `.env*` is copied with no overwrite (symlinks skipped)
- refuses to operate if `.worktrees/` or any worktree path component is a symlink
- `copy-env` only targets registered worktrees
- `origin` fetch is optional; local base refs are allowed
- fetch from `origin` only when base looks like a branch
- Worktrees live under `.worktrees/`
- `create` initializes `.worktrees/.gitignore` (`*` plus `!.gitignore`) when
absent, so `git add -A` cannot stage nested worktrees as gitlinks; existing
custom ignore files are preserved
**Shared claim state.** Parallel agents in sibling worktrees driving `flowctl` on the same repo share claim state via `.git/flow-state`. Set `FLOW_STATE_DIR` per agent (outside the tree) when running flow pipelines concurrently.
© Gordon Mickel · MIT · gmickel/flow-next