finishing-a-development-branch

Verify tests and guide Git branch merge, pull request, keep, or discard decisions.

5|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/tiancaiamao/ai --skill finishing-a-development-branch-tiancaiamao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/tiancaiamao/ai/tree/main/skills/finishing-a-development-branch
Command: npx skills add https://github.com/tiancaiamao/ai --skill finishing-a-development-branch-tiancaiamao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps you finish a completed development branch safely by checking test status first and then guiding the final integration decision.

Core Features & Use Cases

  • Verifies the project test suite before any completion step.
  • Determines the base branch and presents four fixed completion choices.
  • Handles local merge, push-and-PR, keeping the branch, or discarding it with confirmation and worktree cleanup.
  • Use when a feature branch is done and you need a structured handoff, merge, or cleanup flow.

Quick Start

Ask me to use the finishing-a-development-branch skill to wrap up this completed feature branch.

Frequently Asked Questions about finishing-a-development-branch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely merge a finished git branch after tests pass?

To safely merge a finished git branch, you must verify the project test suite first, detect the base branch, and then choose between local merge, push-and-PR, keeping, or discarding with worktree cleanup.

What's the best way to clean up a git worktree after merging a branch?

The best way to clean up a git worktree after merging is to select the local merge or discard option in a fixed four-option workflow, which automatically handles worktree cleanup for the deleted or integrated branch.

Does this branch finishing workflow support creating a pull request?

Yes, the branch finishing workflow supports creating a pull request by selecting the push-and-PR option after test validation and base-branch detection confirm the feature is ready for integration.

How do I discard a git development branch without leaving orphaned worktrees?

To discard a git development branch without orphaned worktrees, use a discard confirmation step that ensures the branch is abandoned and the associated worktree is properly removed during cleanup.

What happens if test validation fails before a branch merge?

If test validation fails before a branch merge, the fixed four-option completion workflow is blocked, preventing the local merge, pull request, or discard actions from proceeding until tests pass.