用途:在实现完成、测试通过后,帮助决定如何整合开发分支的工作。核心流程为:验证测试 → 呈现选项 → 执行所选方案 → 更新项目上下文 → 清理。开始时需声明正在使用该技能。
主要能力与用法:
- 验证测试:先运行项目测试套件(如 npm test、cargo test、pytest、go test ./...)。若测试失败,必须停止,不得进入下一步,也不能合并或建 PR。
- 确定基础分支:可用 git merge-base HEAD main 或 git merge-base HEAD master 判断,或向用户确认。
- 呈现四个选项:本地合并回基础分支、推送并创建 Pull Request、保持分支原样、丢弃该工作。选项需简洁,不加额外解释。
- 执行选择:本地合并需切换基础分支、拉取、合并、在合并结果上再验证测试,通过后删除特性分支;建 PR 需推送分支并用 gh pr create 创建;保留分支则保留 worktree;丢弃需用户输入 discard 确认后强制删除分支。
- 更新项目上下文:合并或建 PR 前,调用 ed3d-extending-claude:project-claude-librarian 更新 CLAUDE.md(若契约或结构有变化)。该子代理不得再派发子代理;若插件不可用则跳过并说明。丢弃选项跳过此步。
- 清理 worktree:选项 1、2、4 需检查并移除 worktree;选项 3 保留。
- 提醒测试计划:选项 1、2、3 若存在 docs/test-plans/ 下的人工测试计划,提醒用户查看。
限制与注意:不得在测试失败时继续;不得未经确认删除工作;不得在未明确要求时强制推送;仅选项 1 和 4 清理 worktree;选项 4 必须输入 discard 确认。该技能由 executing-an-implementation-plan 调用,并与 using-git-worktrees 配合使用。具体命令与参数以资料为准,未提供的细节暂未说明。