核心功能
finishing-branch 是一个 Git 开发工作流自动化技能,专注于功能开发完成后的分支收尾阶段。它在确保测试通过的前提下,以结构化决策树替代开放式询问,提供四种互斥的集成路径。
显著优点
1. 强制质量门禁:内置测试验证前置条件,测试失败则阻断流程,避免将缺陷代码带入主干
2. 结构化决策:用 4 个明确选项替代模糊的 "接下来做什么",减少沟通摩擦与决策疲劳
3. 工作区感知:自动检测并清理 Git worktree,防止磁盘空间泄漏
4. 安全防护:丢弃变更需输入 "discard" 确认,防止误删工作成果
5. PR 模板化:自动填充标准 PR 结构(Summary + Test Plan),提升协作规范性
潜在局限
- CI/CD 盲区:仅执行本地测试,不等待远程 CI 结果,可能合并未通过云端检查的分支
- 权限假设:
gh pr create依赖本地 GitHub CLI 认证,未处理企业版或复杂权限场景 - 单分支模型:未覆盖多分支依赖、stacked PR 等高级 Git 工作流
- 无回滚机制:执行合并/删除后无自动恢复路径
适合人群
- 追求 Git 工作流自动化的独立开发者
- 采用 feature branch 模型的中小团队
- 频繁使用
git worktree管理多上下文的开发者
常规风险
- 误操作风险:本地合并后若未推送,可能与其他开发者冲突
- 确认疲劳:频繁输入 "discard" 可能导致机械性确认
- 工具依赖:依赖
ghCLI,环境缺失时流程中断
技术实现
解析当前分支与基准分支关系,通过 shell 命令执行 Git 操作,结合条件判断实现分支生命周期管理。