开发与工程 git-workflowpull-requestsbranch-cleanupworktreestest-verificationmerge-management

开发分支收尾助手

在测试通过后安全完成分支合并、PR、保留或清理。

FollowSkills 评估 · FSRS-2.0
不推荐
44/ 100 五分制 2.2 / 5
1 2 3 4 5 6
1信任安全15 / 25 · 3.0/5

技能要求先验证测试,并对合并、推送、保留或丢弃提供用户选择;丢弃操作要求输入 discard,且对 worktree 所有权有检查,降低了误删风险。扣分原因是推送、拉取、合并和强制删除仍会产生外部或不可逆影响,未明确逐项确认、回滚方案、敏感数据处理或命令失败后的恢复路径。

2可靠稳定6 / 20 · 1.5/5

流程顺序清晰,涵盖测试失败停止、环境检测、分支判断和清理条件。扣分原因是测试命令以“npm test / cargo test / pytest / go test ./...”形式并列,缺少项目识别和可复现命令;对命令失败、分支不存在、远端不可用、冲突或权限错误的反馈和处理不足。静态评估不超过10分。

3适用触发8 / 15 · 2.7/5

目标场景明确:实现完成且测试通过后决定合并、PR、保留或清理;正常仓库、命名 worktree 和 detached HEAD 有不同菜单。扣分原因是对非 Git 项目、无测试项目、复杂分支拓扑、无远端或不同宿主代理的适用边界不充分,也没有中文交互或中国大陆网络环境说明。

4规范维护8 / 15 · 2.7/5

文档采用步骤、选项表、快速参考、常见错误和红线分层组织,命名和菜单稳定;仓库上下文提供 MIT 许可证和版本号。扣分原因是选定技能自身没有安装说明、版本约束、变更记录、维护责任或更新路径,且发布者身份未被 FollowSkills 注册表验证。

5有效结果5 / 15 · 1.7/5

技能能够把完成开发分支后的决策和清理流程标准化,并明确保留 PR worktree 和删除前确认。扣分原因是核心测试命令、基础分支识别和不同项目环境仍需人工补充,静态文件未提供该技能关键路径的直接可用输出或执行证据;静态评估不超过7分。

6证据核验2 / 10 · 1.0/5

技能文本包含可审计的命令、状态条件和错误规则,README 还提到仓库存在测试与评估基础设施。扣分原因是提供的测试材料主要覆盖其他组件,没有显示该技能行为的专门测试或第三方执行结果,无法独立复现其关键路径;静态评估不超过5分。

证据充分度: 评估于 2026年7月19日 审查版本 d884ae04edeb
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 不要把示例中的多个测试命令直接作为一条 shell 命令执行;应先识别项目实际测试入口。
  • 推送、拉取、合并和 git branch -D 会改变远端或本地历史;执行前应确认目标分支、远端和可恢复状态。
  • 丢弃流程虽要求 discard,但仍应核对提交列表、worktree 路径及其所有权,避免误删宿主环境创建的工作区。
  • 该技能没有针对中文交互、非 Git 项目或中国大陆网络环境的适配说明。
评估证据 [1][2][3][4][5][6][7]
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

这是 Superpowers 集合中的一个开发分支收尾技能,专门处理实现完成后的集成决策。它先验证测试,再检测 Git 仓库或 worktree 环境,并根据状态展示合并、创建 PR、保留或丢弃等选项。选择合并或丢弃时,它还会按来源判断是否可以清理 worktree。该技能不负责实现功能,也不会在测试失败时继续合并或创建 PR。

运行项目测试命令并检查失败情况;读取 Git 目录、公共 Git 目录、当前分支、HEAD 状态和 worktree 路径;尝试确定 main 或 master 作为基准分支;根据普通仓库、命名分支 worktree 或 detached HEAD 展示对应菜单;执行本地合并、推送分支、保留分支或经确认后丢弃分支;合并后重新验证测试;仅在允许的情况下移除 worktree、运行 git worktree prune,并删除分支。

  1. 开发者已完成实现且测试通过,需要决定是本地合并还是创建 Pull Request。
  2. 开发者在 Git worktree 中完成任务,需要在合并或丢弃后安全清理工作区。
  3. 开发者处于 detached HEAD 的外部托管工作区,需要避免显示不适用的本地合并选项。
  4. 团队希望在删除分支或工作区前获得明确的丢弃确认。

这个 Skill 有哪些优点和局限?

优点
  • 先验证测试,再提供集成选项,流程清晰。
  • 区分普通仓库、命名分支 worktree 和 detached HEAD,减少不适用操作。
  • 只对技能创建的 .worktrees/ 或 worktrees/ 路径执行 worktree 清理。
  • 丢弃操作要求明确的 discard 确认。
局限
  • 要求项目已有可运行的测试命令;具体测试命令需要按项目情况提供。
  • 技能只覆盖开发分支收尾,不负责编码、调试或编写测试。
  • README 没有提供该单个技能的独立安装流程。
  • 创建 PR 的推送流程依赖可用的远程仓库和 Git 权限。

如何安装这个 Skill?

该技能没有单独安装说明;它位于 Superpowers 单仓库的 skills/finishing-a-development-branch/SKILL.md 中。README 说明应按所使用的 coding-agent harness 分别安装整个 Superpowers 集合,例如 Codex CLI 中打开 /plugins,搜索 superpowers 并选择 Install Plugin。

如何使用这个 Skill?

在实现完成且所有测试通过后触发。技能开始时应宣布:"I'm using the finishing-a-development-branch skill to complete this work." 随后运行项目测试,例如 npm test、cargo test、pytest 或 go test ./...,检测 Git 环境并选择菜单项。若测试失败,先修复失败,不进入合并或 PR 流程;若选择丢弃,必须准确输入 discard 确认。

常见问题

它是否免费?
来源只明确说明 Superpowers 使用 MIT License;该技能本身没有单独定价信息。
测试失败时会发生什么?
技能应显示失败数量和失败信息,并停止后续菜单流程;不会继续合并或创建 PR。
它会删除所有 worktree 吗?
不会。只有位于 .worktrees/ 或 worktrees/ 下、被 Superpowers 创建的 worktree 才会按流程清理;其他由宿主环境管理的工作区应保留。
创建 Pull Request 后会清理工作区吗?
不会。创建 PR 的选项会保留 worktree,以便继续处理 PR 反馈。

同仓库的其他 Skills

均来自 obra/superpowers

相关 Skills