finishing-branch

Finishing-branch 是一个专注于开发流程闭环管理的自动化技能，旨在帮助开发者在功能实现完成后，以标准化、安全化的方式处理代码集成与分支清理工作。该工具通过结构化的决策流程，将测试验证、分支操作和工作树管理整合为统一的解决方案，特别适用于遵循Git Flow或GitHub Flow的现代开发团队。

核心用法
该技能在检测到"finish branch"、"complete branch"等关键词时触发，执行五阶段工作流：首先强制验证测试状态（支持npm test、cargo test、pytest等主流框架），测试失败则立即中止；其次确定基础分支（main/master）；随后呈现四种互斥选项——本地合并、创建Pull Request、保留分支或丢弃更改；根据用户选择执行相应的git操作（merge、push、gh pr create等）；最后智能清理工作树（保留选项除外）。整个过程强调状态检查与确认机制，确保每一步都可控可回退。

显著优点
流程标准化是其最大价值，通过固化"测试-决策-执行-清理"的最佳实践，显著减少人为操作失误。安全设计尤为突出：内置main/master分支保护机制防止误操作生产分支；强制检查工作树状态，避免未提交更改意外丢失；删除操作采用 typed confirmation 机制，必须输入"discard"才执行强制删除；提供--dry-run模式用于预览操作。对Git工作树（worktree）的原生支持，使其在现代Git工作流中具备独特优势，能自动清理关联的工作目录。

潜在缺点与局限性
作为T3来源的社区项目，长期维护与代码审计频率不及企业级工具。功能上依赖系统git命令和特定测试框架的自动识别，在高度定制化的CI环境或非常规项目结构中可能需要手动调整。虽然使用了shell=True执行测试命令，但仅限于固定的模式匹配（make test/npm test等），灵活性受限。此外，该技能主要面向本地开发环境，与远程仓库的交互依赖gh CLI工具，环境依赖较重，未安装GitHub CLI的用户无法使用PR创建功能。

适合的目标群体
特别适合遵循Git Flow或GitHub Flow的个人开发者与中小团队，尤其是使用VS Code、Cursor等AI编辑器配合Git工作树的场景。对于需要频繁切换功能分支、重视本地测试验证、希望规范化PR流程的前后端开发者具有直接价值。也适用于教学场景，帮助新手建立标准的代码集成习惯，避免因误操作导致的主分支污染或代码丢失。

使用风险
主要风险集中在git操作本身：尽管有确认机制，但强制删除分支（-D）仍可能导致未推送工作丢失；自动工作树清理若配合选项1/2/4执行，可能误删仍在使用的目录；subprocess调用git命令虽无注入风险，但在环境变量异常或git配置错误时可能产生非预期行为。建议始终先使用--dry-run验证，并确保git config配置正确，特别是在处理重要生产代码时。