Skip to content

如何让 AI 标准化地完成开发分支的合并与清理

解决 AI 在完成代码编写后缺乏统一收尾标准的问题:通过强制执行“验证-选择-执行-清理”流程,确保代码在合并前通过测试,并由用户决定最终的集成方式。

为什么需要这个技能

在实际开发中,AI 完成代码编写并不意味着任务结束。如果 AI 直接将代码合并或随意关闭分支,容易导致以下问题:

  • 破坏主干:未经过测试就合并,导致 CI/CD 崩溃。
  • 混乱的分支:留下大量无用的临时分支或未清理的 git worktree
  • 沟通缺失:缺乏标准的 Pull Request 描述,导致代码评审困难。

本技能为 AI 设定了一套严格的收尾协议,将“执行合并”这一高风险操作转化为“结构化选项选择”,确保代码集成过程安全、可追溯且整洁。

适用场景

  • 当 AI 完成了一个功能模块的实现,且所有单元测试均通过时。
  • 需要将开发分支集成到 mainmaster 等主干分支时。
  • 在使用 git worktree 管理多任务,需要在任务结束时释放磁盘空间的场景。
  • 需要 AI 自动生成标准化 PR 描述并提交至 GitHub/GitLab 时。

核心工作流

AI 将严格按照以下五个步骤执行:

  1. 强制验证测试:在提供任何合并选项前,必须先运行项目的测试套件(如 npm testpytest)。如果测试失败,直接停止流程并报告错误,禁止进入下一步。
  2. 确定基准分支:通过 git merge-base 自动识别该分支是从哪个主干分支(如 mainmaster)切出的。
  3. 呈现结构化选项:AI 不会询问“接下来做什么”,而是给出四个明确选项:
    • 本地合并:直接将改动合并至本地基准分支并删除原分支。
    • 创建 PR:推送分支并使用 gh 命令行工具创建包含总结和测试计划的 Pull Request。
    • 保持现状:保留分支和工作区,由用户后续处理。
    • 丢弃工作:永久删除该分支及相关提交(需用户输入 discard 确认)。
  4. 执行选定操作:根据用户选择执行对应的 Git 命令。
  5. 清理工作区:针对本地合并、PR 创建或丢弃操作,AI 会自动检查并移除对应的 git worktree,保持环境整洁。

下载和安装

下载 finishing-a-development-branch 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹,重启工具后即可使用。具体路径参考内附的 USAGE.zh.md

你可能还需要

暂无推荐