Appearance
如何让 AI 标准化地完成开发分支的合并与清理
解决 AI 在完成代码编写后缺乏统一收尾标准的问题:通过强制执行“验证-选择-执行-清理”流程,确保代码在合并前通过测试,并由用户决定最终的集成方式。
为什么需要这个技能
在实际开发中,AI 完成代码编写并不意味着任务结束。如果 AI 直接将代码合并或随意关闭分支,容易导致以下问题:
- 破坏主干:未经过测试就合并,导致 CI/CD 崩溃。
- 混乱的分支:留下大量无用的临时分支或未清理的
git worktree。 - 沟通缺失:缺乏标准的 Pull Request 描述,导致代码评审困难。
本技能为 AI 设定了一套严格的收尾协议,将“执行合并”这一高风险操作转化为“结构化选项选择”,确保代码集成过程安全、可追溯且整洁。
适用场景
- 当 AI 完成了一个功能模块的实现,且所有单元测试均通过时。
- 需要将开发分支集成到
main或master等主干分支时。 - 在使用
git worktree管理多任务,需要在任务结束时释放磁盘空间的场景。 - 需要 AI 自动生成标准化 PR 描述并提交至 GitHub/GitLab 时。
核心工作流
AI 将严格按照以下五个步骤执行:
- 强制验证测试:在提供任何合并选项前,必须先运行项目的测试套件(如
npm test或pytest)。如果测试失败,直接停止流程并报告错误,禁止进入下一步。 - 确定基准分支:通过
git merge-base自动识别该分支是从哪个主干分支(如main或master)切出的。 - 呈现结构化选项:AI 不会询问“接下来做什么”,而是给出四个明确选项:
- 本地合并:直接将改动合并至本地基准分支并删除原分支。
- 创建 PR:推送分支并使用
gh命令行工具创建包含总结和测试计划的 Pull Request。 - 保持现状:保留分支和工作区,由用户后续处理。
- 丢弃工作:永久删除该分支及相关提交(需用户输入
discard确认)。
- 执行选定操作:根据用户选择执行对应的 Git 命令。
- 清理工作区:针对本地合并、PR 创建或丢弃操作,AI 会自动检查并移除对应的
git worktree,保持环境整洁。
下载和安装
下载 finishing-a-development-branch 中文版 Skill ZIP
解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。
你可能还需要
暂无推荐