Завершение ветки разработки

Завершает ветку: прогоняет тесты, предлагает слить локально, открыть PR или оставить как есть, после слияния снова проверяет тесты и убирает свой worktree, а работу удаляет только после «discard». Для случаев, когда реализация готова.

Git и PRПак: Superpowers225 строкfinishing-a-development-branch
Автор
Источник
obra/superpowers/skills/finishing-a-development-branch @ 22f0b46
Лицензия
MIT · Copyright (c) 2025 Jesse Vincent

Об этом скилле

Что делает

Скилл отвечает за момент, когда код написан и надо решить, что делать с веткой. Агент прогоняет все тесты и останавливается, если что-то упало. Затем определяет, где находится — в обычной рабочей копии, в worktree на именованной ветке или на detached HEAD в пространстве, которым управляет среда, — уточняет базовую ветку, если она неизвестна, и показывает фиксированное меню: слить локально, запушить и открыть pull request или оставить ветку как есть. На detached HEAD слияния в меню нет. Решаете вы, агент ждёт.

При локальном слиянии тесты прогоняются ещё раз, уже на результате, и только если они зелёные, агент удаляет worktree и ветку через git branch -d. Pull request открывается через CLI хостинга или по ссылке, которую тот выдаёт при пуше, по шаблону PR из репозитория, а worktree остаётся — в нём правят замечания ревью. Выбросить работу через меню нельзя: только по вашей просьбе и после того, как вы наберёте discard. Уборка касается лишь worktree в .worktrees/ или worktrees/, которые создал сам Superpowers; если в таком worktree остались незакоммиченные файлы, агент показывает их и спрашивает, а не берётся за --force. Если пуш отклонён, force-push агент делает только по вашему прямому указанию.

В папке только SKILL.md и лицензия.

Когда включать и когда не надо

Когда реализация готова и хочется, чтобы интеграция каждый раз проходила одинаково, особенно если агенты работают в worktree.

Пока тесты красные, толку не будет: скилл перечислит падения и остановится. Код он не ревьюит, готовность к проду не оценивает и не подсказывает, что писать в описании PR.

Как поставить и вызвать

Команда установки ниже кладёт папку целиком. Агент сам подхватывает скилл по описанию. Вызвать вручную:

  • Claude Code: /finishing-a-development-branch или попросить скилл по имени.
  • Codex: $finishing-a-development-branch.
  • Cursor: наберите / в чате Agent и выберите finishing-a-development-branch.

Пример: /finishing-a-development-branch Работа над rate limit закончена. Прогони тесты и предложи варианты для этой ветки.

executing-plans и subagent-driven-development вызывают этот скилл последним шагом, а его уборка рассчитана на раскладку, которую создаёт using-git-worktrees. Ставьте их вместе.

Чем отличается от похожих

Самопроверка перед PR из нашего каталога читает diff в поисках отладочного мусора, секретов, выхода за рамки задачи и недостающих тестов. Этот скилл код вообще не читает, так что самопроверку стоит пройти раньше. Описание PR пишет текст того pull request, который открывает второй вариант меню; Заголовок и описание PR от Sentry тоже пишет его и сам открывает PR черновиком. Доводка PR до зелёного CI подхватывает уже открытый PR: чинит упавшие проверки и замечания ревью высокой и средней важности, пушит и повторяет, пока CI не позеленеет. Чек-лист релиза — следующий этап: решение «выпускаем или нет» перед выкаткой, с миграциями, конфигом и планом отката.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/finishing-a-development-branch/SKILL.md https://anymodel.org/en/skills/superpowers/finishing-a-development-branch/SKILL.md -o ~/.claude/skills/finishing-a-development-branch/LICENSE https://anymodel.org/en/skills/superpowers/finishing-a-development-branch/LICENSE
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/finishing-a-development-branch/SKILL.md https://anymodel.org/en/skills/superpowers/finishing-a-development-branch/SKILL.md -o ~/.agents/skills/finishing-a-development-branch/LICENSE https://anymodel.org/en/skills/superpowers/finishing-a-development-branch/LICENSE
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE') { $p = Join-Path "$HOME\.claude\skills\finishing-a-development-branch" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/superpowers/finishing-a-development-branch/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE') { $p = Join-Path "$HOME\.agents\skills\finishing-a-development-branch" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/superpowers/finishing-a-development-branch/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/superpowers/finishing-a-development-branch/SKILL.md

SKILL.md

Исходник

Finishing a Development Branch

Overview

Core principle: Verify tests → Detect environment → Present options → Execute choice → Clean up.

Announce at start: "I'm using the finishing-a-development-branch skill to complete this work."

Step 1: Verify Tests

Run the project's full test suite (npm test / cargo test / pytest / go test ./...).

If tests fail, report the failures and stop — the menu comes after a green suite:

Tests failing (<N> failures). Must fix before completing:

[Show failures]

If tests pass: continue to Step 2.

Step 2: Detect Environment

GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
# Capture now, while still inside the workspace — Step 5 changes directory
# before cleanup (Step 6) needs this value
WORKTREE_PATH=$(git rev-parse --show-toplevel)

This determines which menu to show and how cleanup works:

State Menu Cleanup
GIT_DIR == GIT_COMMON (normal repo) Standard 3 options No worktree to clean up
GIT_DIR != GIT_COMMON, named branch Standard 3 options Provenance-based (see Step 6)
GIT_DIR != GIT_COMMON, detached HEAD Reduced 2 options (no merge) Externally managed — leave in place

Step 3: Determine Base Branch

The base branch is whatever this work forked from — usually named in the plan, the conversation, or the branch's upstream. If it is not already known, ask: "This branch split from <your best guess> - is that correct?" Confirm before merging: merging into the wrong base is expensive to undo.

Step 4: Present Options

Normal repo and named-branch worktree — present exactly these 3 options:

Implementation complete. What would you like to do?

1. Merge back to <base-branch> locally
2. Push and create a Pull Request
3. Keep the branch as-is (I'll handle it later)

Which option?

Detached HEAD — present exactly these 2 options:

Implementation complete. You're on a detached HEAD (externally managed workspace).

1. Push as new branch and create a Pull Request
2. Keep as-is (I'll handle it later)

Which option?

Present the menu exactly as written — concise, with every option coming from the list above. Discarding the work happens only in response to your human partner explicitly asking for it (see "If your human partner asks to discard the work" below). Wait for their answer; the integration decision is theirs.

Step 5: Execute Choice

Option 1: Merge Locally

# Get main repo root for CWD safety
MAIN_ROOT=$(git -C "$(git rev-parse --git-common-dir)/.." rev-parse --show-toplevel)
cd "$MAIN_ROOT"

# Merge first — verify success before removing anything
git checkout <base-branch>
git pull
git merge <feature-branch>

# Verify tests on merged result
<test command>

If tests fail on the merged result: stop, leave the worktree and branch in place, and investigate — nothing has been pushed, so the merge is local and recoverable.

Once the merged result is green: clean up the worktree (Step 6), then delete the branch:

git branch -d <feature-branch>

Option 2: Push and Create PR

git push -u origin <feature-branch>
# From a detached HEAD, name the new branch on the remote:
# git push origin HEAD:refs/heads/<new-branch>

Then create the pull/merge request against <base-branch> with the forge's tooling — its CLI if one is available, or the creation URL most forges print when you push — following the repo's PR template and conventions if present, and report the URL to your human partner.

Keep the worktree — your human partner iterates on PR feedback there.

Option 3: Keep As-Is

Report: "Keeping branch <name>. Worktree preserved at <path>."

If your human partner asks to discard the work

This path exists only as a response to an explicit request to throw the work away. Confirm first:

This will permanently delete:
- Branch <name>
- All commits: <commit-list>
- Worktree at <path>

Type 'discard' to confirm.

Wait for that exact confirmation. When it arrives:

MAIN_ROOT=$(git -C "$(git rev-parse --git-common-dir)/.." rev-parse --show-toplevel)
cd "$MAIN_ROOT"

Then clean up the worktree (Step 6) and force-delete the branch:

git branch -D <feature-branch>

Step 6: Cleanup Workspace

Runs for Option 1 and confirmed discards. Options 2 and 3 always preserve the worktree. Both callers have already changed directory to the main repo root — worktree removal must run from outside the worktree — and use the GIT_DIR/GIT_COMMON/WORKTREE_PATH values captured in Step 2, from before that directory change.

If GIT_DIR == GIT_COMMON: Normal repo, no worktree to clean up. Done.

If WORKTREE_PATH is under .worktrees/ or worktrees/: Superpowers created this worktree — we own cleanup:

git worktree remove "$WORKTREE_PATH"
git worktree prune  # Self-healing: clean up any stale registrations

If removal is refused (contains modified or untracked files): the worktree holds files that exist nowhere else — uncommitted plans, notes, or scratch work. Never --force on your own initiative. Show your human partner what is at stake and ask:

git -C "$WORKTREE_PATH" status --porcelain -uall
Worktree removal refused — these files were never committed:

<file list>

1. Commit them to <branch> before cleanup
2. Move them into <main repo root>
3. Delete them (unrecoverable)

Which?

Carry out the choice, then remove the worktree.

Otherwise: The host environment owns this workspace — leave it in place. If your platform provides a workspace-exit tool, use it.

Quick Reference

Option Merge Push Keep Worktree Cleanup Branch
1. Merge locally yes - - yes
2. Create PR - yes yes -
3. Keep as-is - - yes -
Discard (explicit request only) - - - yes (force)

Common Rationalizations

Excuse Reality
"Tests passed earlier this session" Run the suite on the tree you are about to integrate. A green run only proves the tree it ran on.
"They obviously want it merged" Integration is your human partner's decision. Present the menu and wait.
"They seem done with this feature — I'll offer to discard it" The menu is complete as written. Discard happens only when your human partner asks for it in so many words.
"'Yeah, get rid of it' counts as confirmation" Only the typed word discard authorizes deletion.
"The PR is up, so the worktree is clutter now" PR feedback gets fixed in that worktree. It stays until the work lands.
"This other worktree looks stale — I'll clean it too" Clean up only worktrees under .worktrees/ or worktrees/. Everything else belongs to the host.
"Removal refused — --force is just finishing the cleanup" The refusal means files exist only in that worktree. --force destroys them permanently. Show your human partner and ask.
"The merged-result failure is probably flaky" A failing merged result stops everything. Branch and worktree stay put while you investigate.
"The base branch is obviously main" Confirm the fork point or ask. Merging into the wrong base is expensive to undo.
"The push was rejected — force-push will fix it" A rejected push means the remote moved. Investigate; force-push only on your human partner's explicit request.

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Superpowers

Брейншторм перед работой

Выясняет, что и зачем вы хотите построить: вопросы по одному, пересказ по частям, два-три способа на выбор и дизайн-документ, без одобрения которого код не пишется. Для новых фич и изменений, когда запрос оставляет главное открытым.

Параллельные субагенты

Раздаёт независимые задачи параллельным субагентам: каждому — одна область и самодостаточное задание с рамками и форматом отчёта, потом сверяет правки на конфликты и гоняет все тесты. Для случаев, когда упало сразу несколько несвязанных мест.

Выполнение плана по шагам

Выполняет план из writing-plans в текущей сессии без субагента на каждую задачу: задачи подряд через TDD, журнал прогресса и спорных решений на случай сжатия контекста, одно свежее ревью всей ветки в конце. Для случаев, когда ревью каждой задачи не нужно или субагентов нет.

Как принимать код-ревью

Сверяет каждое замечание ревьюера с кодом до правок, сначала выясняет всё неясное, возражает с доводами и не изображает согласие. Для случаев, когда нужно отработать ревью без слепых правок.

Запрос код-ревью

Отдаёт законченную работу свежему субагенту-ревьюеру по шаблону: диапазон коммитов, план или требования, замечания по важности и вердикт о мерже. Для случаев, когда закончена задача или фича и впереди мерж в main.

Разработка через субагентов

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

Системная отладка

Не даёт агенту чинить наугад: сначала воспроизвести баг и найти первопричину, проверять по одной гипотезе, исправлять с падающим тестом, а после трёх неудачных правок пересмотреть устройство кода. Для любых багов, падений тестов и странного поведения.

TDD по методу Superpowers

Ведёт работу тестом вперёд: сначала тест и его падение, потом минимум кода и прогон всего набора; код, написанный до теста, удаляется. Для фич и багфиксов, когда агент норовит дописать тесты после кода.

Работа в git worktree

Выносит работу над фичей в отдельный git worktree: проверяет, не изолирован ли агент уже, предпочитает родной инструмент среды, следит за .gitignore, ставит зависимости и прогоняет тесты на старте. Для случаев, когда работа не должна попасть в текущую ветку.

Проверка перед словом «готово»

Не даёт агенту сказать «готово» или «тесты проходят», пока он заново не запустил проверку и не прочитал вывод целиком. Для случаев, когда агент докладывает об успехе, коммитит или открывает PR.

План реализации перед кодом

Превращает спецификацию в план для исполнителя, не знающего проекта: файлы, сигнатуры, интерфейсы между задачами, тесты с точными значениями и шаги TDD с ожидаемым выводом команд. Для многошаговых задач, когда спецификация готова, а кода ещё нет.

Как писать скиллы

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