using-git-worktrees - Изоляция задачи в рабочей копии Git

Когда звать

• Когда параллельная задача требует отдельной копии репозитория без переключения текущей работы.
• Когда перед созданием копии нужно выбрать каталог, проверить исключение из Git и состояние тестов.

Проверить существующую изоляцию

Using-git-worktrees помогает отделить новую задачу от текущей рабочей копии Git. В закреплённой версии Superpowers он начинается не с создания каталога, а с проверки: возможно, среда уже предоставила изолированное место. Повторная копия в таком случае лишь усложнит работу. Автор предлагает сначала распознать готовую изоляцию, затем использовать штатный инструмент платформы и только после этого обращаться к ручному созданию через Git.

Проверка сравнивает пути служебного каталога Git и общего служебного каталога. Если они различаются, это может означать связанную рабочую копию. Есть отдельная защита от неверного вывода: подмодуль тоже даёт такое различие, поэтому сначала проверяется наличие родительского проекта. Для уже готовой копии агент сообщает текущую ветку либо состояние detached HEAD, когда именованная ветка пока не выбрана.

Согласие и выбор места

Если обычный репозиторий ещё не изолирован, инструкция требует учитывать ранее заданное предпочтение пользователя. При отсутствии такого указания предлагается спросить согласие на отдельную копию. Отказ означает работу на месте с дальнейшей настройкой и тестами. Это не разрешение менять общую ветку другого участника: конкретные права определяются вашим рабочим процессом.

При создании приоритет получает штатный инструмент среды, поскольку он сам управляет размещением, веткой и очисткой. Ручной вариант нужен только при отсутствии такого механизма. В выборе пути прямое указание пользователя сильнее существующего каталога. Далее учитываются .worktrees/ и worktrees/; если специальных указаний нет, автор использует скрытую папку в корне проекта.

Для папки внутри репозитория требуется проверить исключение из отслеживания через gitignore. Иначе содержимое копии можно случайно включить в коммит основного проекта. Источник предлагает добавить исключение при его отсутствии. Перед подобным изменением стоит проверить собственные правила: они могут задавать другое место, специальный скрипт частичной копии или запрет изменения служебных файлов. Чужая инструкция не отменяет эти ограничения.

Исходное состояние важнее красивого каталога

После подготовки агент определяет тип проекта по его файлам и выбирает подходящую настройку. В источнике приведены примеры для Node.js, Rust, Python и Go. Команды установки нужно предварительно сверить с безопасным режимом конкретного репозитория; мы их не выполняли. Затем запускаются исходные тесты, чтобы будущие сбои можно было отличить от уже существовавших.

При красных тестах инструкция предлагает сообщить об отказах и решить, продолжать ли работу. При зелёных можно переходить к реализации. Скилл относится к подготовке места, а finishing-a-development-branch описывает последующее завершение. Проверенная карточка подтверждает содержание файлов и лицензию MIT, но не обещает, что создание копии получится в любой песочнице или что зависимости проекта будут доступны.