finishing-a-development-branch

核心用法

该Skill提供了一套标准化的Git分支完成流程，适用于功能开发完成后需要决定如何集成代码的场景。流程遵循"验证测试→展示选项→执行选择→清理环境"的核心原则。首先强制要求运行项目测试套件（npm test、pytest、cargo test等），只有测试通过后才会展示四种明确的选项：本地合并回主分支、推送并创建Pull Request、保持分支现状暂不处理、或彻底丢弃当前工作。根据用户选择，Skill会指导执行相应的Git命令序列，包括切换分支、合并、推送、创建PR等操作，并在最后自动清理工作树（worktree）环境，形成完整的开发闭环。

显著优点

最大的优势在于强制测试验证机制，确保只有在代码质量达标后才允许进行合并或PR操作，从源头避免将 broken code 带入主分支。其次，提供结构化的四选项决策框架，消除了"接下来该做什么"的模糊性，特别适合团队协作场景下统一工作流规范。Skill还内置了完善的安全确认机制，对于不可逆的丢弃操作要求用户输入明确的"discard"确认，防止误删重要工作。此外，对工作树（worktree）的智能清理管理，避免了临时工作目录的堆积，保持开发环境整洁，这一点对于同时处理多个功能分支的开发者尤为重要。

潜在缺点

作为纯文档型Skill，它仅提供流程指导而不具备自动化执行能力，所有Git命令仍需用户手动输入执行，在效率提升上相对有限。另外，该Skill假设项目使用标准的Git工作流（main/master分支模型），对于使用复杂分支策略（如Git Flow变种、多环境分支模型）的团队可能需要额外调整。文档中提到的测试命令是通用示例，对于有特殊测试配置或构建系统的项目，可能需要手动调整命令。此外，Skill与GitHub CLI（gh）工具深度集成，如果团队使用其他代码托管平台（GitLab、Bitbucket等），创建PR的步骤需要相应调整。

适合的目标群体

主要面向采用Git版本控制的软件开发团队，特别是需要规范代码集成流程的中小型团队。对于刚接触Git工作流的新手开发者，该Skill提供了清晰的步骤指引和安全检查点；对于经验丰富的开发者，它作为检查清单确保不遗漏测试验证和环境清理环节。特别适合使用GitHub工作流（集成gh CLI工具创建PR）的团队，以及采用工作树（worktree）进行多分支并行开发的开发者。对于重视代码质量门禁、希望建立标准化开发流程的技术团队，该Skill提供了可落地的操作规范。

使用风险

该Skill本身为纯Markdown文档，无可执行代码，安全性评级为A级，无网络通信或数据收集行为。主要风险点在于用户手动执行Git命令时的操作失误，特别是在执行强制删除分支（git branch -D）或清理工作树时可能导致数据丢失，尽管Skill设计了确认机制，但仍需用户谨慎操作。另外，来源为T3级别（个人GitHub账号），虽然内容经过安全审计无恶意代码，但长期维护和更新依赖个人开发者。性能方面无特殊要求，但依赖于用户本地已正确配置的Git环境、测试运行环境和GitHub CLI工具（如选择创建PR选项）。