Using Git Worktrees: скилл Superpowers для отдельной рабочей копии

obra/superpowers· Проверено 13.11.2026· 317 тыс.на GitHub

Скилл Superpowers: перед работой над фичей агент проверяет, не в изолированной ли он копии, создаёт git worktree и прогоняет тесты, чтобы начать с чистой базы.

Как установить Using Git Worktrees

Личные скиллы лежат в ~/.claude/skills/, проектные — в .claude/skills/ репозитория. Проверка: команда /skills в сессии, вызов по имени — /using-git-worktrees.

# плагином, внутри Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# или вручную
git clone --depth 1 https://github.com/obra/superpowers.git /tmp/using-git-worktrees
mkdir -p ~/.claude/skills/using-git-worktrees
cp -r /tmp/using-git-worktrees/skills/using-git-worktrees/. ~/.claude/skills/using-git-worktrees/

Что умеет

Определить, работает ли агент уже в отдельном worktree или внутри подмодуля
С вашего согласия создать worktree встроенным инструментом агента (например, EnterWorktree)
Без такого инструмента создать worktree в .worktrees/ командой git worktree add
Проверить, что папка worktree есть в .gitignore, и добавить её туда при необходимости
Поставить зависимости проекта и прогнать тесты до начала работы

Шаг 0 сравнивает git-dir и git-common-dir и отсекает подмодули: если агент уже в worktree, новый не создаётся.

Папка выбирается так: ваше указание, затем существующие .worktrees/ или worktrees/, иначе .worktrees/ в корне проекта.

Зависимости ставятся по файлам проекта: package.json — npm install, Cargo.toml — cargo build, requirements.txt — pip install, pyproject.toml — poetry install, go.mod — go mod download.

Если песочница запрещает git worktree add, агент сообщает об этом и работает в текущей папке.

Что нужноgit
АгентыСтавится вместе с набором Superpowers в Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI, OpenCode, Qwen Code и другие агенты.

Что попросить агента

Начни работу над фичей <экспорт в CSV>Спросит, создать ли изолированный worktree, создаст его на новой ветке, поставит зависимости и прогонит тесты
Ты уже в отдельной копии репозитория?Сверит git-dir с git-common-dir, проверит подмодуль и назовёт путь и ветку
Подготовь рабочую копию под план <docs/superpowers/plans/…>Создаст worktree, отчитается: путь, число тестов, ноль падений, готовность к работе

Ограничения

!

Worktree создаётся только с вашего согласия, если вы не указали предпочтение заранее

!

Сам ставит зависимости проекта в новой копии (npm install, pip install, poetry install и т. п.)

!

Если базовые тесты падают, агент спрашивает, продолжать ли

Описание из SKILL.md

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback

Частые вопросы

Как установить using-git-worktrees skill в Claude Code?
Поставьте набор Superpowers: /plugin install superpowers@claude-plugins-official или через маркетплейс автора obra/superpowers-marketplace. Скилл using-git-worktrees включится сам, когда задача подойдёт.
Куда скилл кладёт worktree?
Туда, куда вы указали; иначе в существующую папку .worktrees/ или worktrees/, а если их нет — в .worktrees/ в корне проекта.
Зачем worktree, если есть ветки?
Worktree — отдельная рабочая папка на своей ветке. Скилл формулирует пользу так: изоляция защищает вашу текущую ветку от изменений.
Почему встроенный инструмент важнее git worktree add?
Инструмент агента сам выбирает папку, создаёт ветку и убирает за собой. Ручной git worktree add рядом с ним создаёт состояние, которого агент не видит; скилл называет это ошибкой номер один.
Когда скилл включается?
Перед работой над фичей, которой нужна изоляция, и перед выполнением плана: его вызывают executing-plans и subagent-driven-development.

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