Claude Code 写完代码后不知道怎么收尾?这个 Skill 给了标准答案
用 Claude Code 写过代码的朋友,可能都遇到过这种情况:功能写完了,测试也过了,但就是不知道该「怎么收尾」。是 merge?开 PR?还是先放着?
今天介绍一个来自 Superpowers 技能集合的技能——finishing-a-development-branch。它专门解决「代码写完了,然后呢」这个问题。
它的核心逻辑
这个技能的核心理念很清晰:验证测试 → 检测环境 → 呈现选项 → 执行选择 → 清理工作区。
第一步,运行完整测试套件。只有测试全绿,才继续往下走。这步卡得很死——「测试之前跑过了」不算数,必须在即将合并的代码上再跑一遍。
第二步,自动检测当前环境:普通仓库、git worktree、还是 detached HEAD。不同状态给出不同的选项菜单。
第三步,把选择权交给人类。技能会显示固定的选项菜单:merge 到本地、开 PR、或者先保留。AI 不猜测、不自作主张,就等着你选。
设计亮点
这个技能最值得开发者关注的点,是它的设计原则:
- 行为边界清晰:菜单是固定的,不会被 AI「优化」掉或擅自修改
- 人类决策优先:merge/PR/keep 的决定必须由人来做,AI 只是执行
- 状态感知:能区分 worktree 和普通仓库,做不同的清理处理
- 零外部依赖:只依赖 git 原生命令,不依赖特定 CI 平台
整个技能就是一个 SKILL.md 文件,逻辑全在 prompt 里,没有任何外部脚本。但它把一个模糊的「写完代码然后呢」变成了一个有边界、可预期、有清理机制的完整流程。
为什么这值得开发者注意
现在的 AI 编程工具,生成代码能力很强,但「收尾」能力普遍偏弱。finishing-a-development-branch 提供了一个很好的示范:如何用 Skill 层让 AI 的行为变得可预期。
它的设计思路可以迁移到很多场景:代码 review 的收尾、测试通过后的发布流程、甚至日常的 git 提交规范。只要你想让 AI 在某个环节有标准行为,都可以参考这个模式:检测状态 → 呈现固定菜单 → 等待人类确认 → 执行。
Superpowers 技能集合在 GitHub 有 270k+ stars,finishing-a-development-branch 是其中专注于开发收尾的一个。整个集合覆盖了从 brainstorm → 开发 → review → 收尾的完整流程,是目前最完整的 AI 编程技能库之一。
使用方式
在 Claude Code 里直接用:
- 当功能开发完成、测试通过后,告诉 Claude Code:「实现已完成,用 finishing-a-development-branch 收尾」
- 技能会自动引导整个流程
GitHub:https://github.com/obra/superpowers
直接访问 Skill:https://github.com/obra/superpowers/tree/main/skills/finishing-a-development-branch
GitHub: https://github.com/obra/superpowers/tree/main/skills/finishing-a-development-branch
评论区
登录后可评论。