Superpowers Finish - Завершение рабочей Git-ветки

Когда звать

• Когда реализация закончена и свежий полный набор тестов уже проходит без ошибок.
• Когда нужно выбрать судьбу ветки: локальное слияние, запрос на проверку или сохранение работы.

Когда реализация уже завершена

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

Затем агент определяет устройство рабочей среды и заранее сохраняет путь текущей копии. Это важно, поскольку дальнейшие действия могут менять каталог. Обычный репозиторий и связанная копия с именованной веткой получают стандартное меню. Для detached HEAD, которым управляет внешняя среда, предусмотрено сокращённое меню без локального слияния. Локальное слияние в таком окружении не предлагается; вместо него можно отправить результат в новую удалённую ветку и создать запрос на проверку.

Какой выбор предлагается человеку

Для именованной ветки доступны локальное слияние с исходной веткой, отправка с созданием запроса на проверку либо сохранение текущего состояния. Исходную ветку нужно определить по плану, разговору или настройке отслеживания. Если она неизвестна, требуется подтверждение. Просто предположить main недостаточно: ошибка в назначении слияния способна затронуть чужую работу.

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

Удаление всей работы отсутствует в обычном меню проверенной версии. Оно появляется только в ответ на отдельную явную просьбу человека. Перед ним перечисляются ветка, коммиты и путь копии, а подтверждение должно содержать точное слово discard. Согласие в общем разговоре не считается таким подтверждением. Для ценных материалов безопаснее заранее сохранить отдельную копию разрешённым способом.

Почему очистка может быть запрещена

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

После успешного локального слияния допустима штатная очистка своей копии; после создания запроса на проверку она сохраняется. Такое различие полезно помнить вместе с using-git-worktrees. Мы изучили основной файл и MIT на точном коммите. Ни слияние, ни отправка, ни удаление по его примерам при подготовке карточки не выполнялись.