用途:在开发工作完成后,引导用户选择如何收尾分支,避免直接合并或随意丢弃代码。核心流程为:验证测试 → 给出选项 → 执行选择 → 清理。
主要能力:
- 先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...),测试失败则停止,不进入下一步。
- 确定基础分支,可用 git merge-base HEAD main 或 master 判断,或向用户确认。
- 固定给出四个选项:本地合并回基础分支、推送并创建 PR、保留分支不动、丢弃该工作。
- 按选择执行:本地合并需切换基础分支、git pull、git merge、在合并结果上再验证测试,通过后 git branch -d;创建 PR 用 git push -u origin <feature-branch> 和 gh pr create;保留则报告分支与工作树位置;丢弃需用户输入 discard 确认后执行 git branch -D。
- 提交前执行强制清理扫描,检查项目根目录异常文件、git worktree prune、清理临时目录,并可记录到会话日志。
- 对选项 1、4 清理工作树,选项 2、3 保留工作树。
使用方式:作为技能在开发分支收尾时调用,通常由 subagent-driven-development 或 executing-plans 在任务完成后触发,并与 using-git-worktrees 配合。
限制与要求:测试未通过不得继续;不得未经确认删除分支或丢弃工作;不得在未明确要求时强制推送或压缩提交;提交前必须通过文档检查(CHANGELOG、README、.env.example、技能描述等)。资料未提供具体安装命令、收费或平台信息。