SuperAPI AI 工具集

git-workflow

编程与开发

查看项目

更新于 10-16 08:10

技能介绍

用途:该技能是一个 Git 工作流专家,为规范驱动开发(spec-driven development)提供贯穿开发生命周期的统一版本控制操作。适用于开始工作前检查仓库状态、为规格或实现创建分支、生成符合约定式提交规范的提交信息、创建基于规格描述的 PR,以及管理分支生命周期(清理、合并状态)。

主要能力:

  1. 仓库检查:使用 git rev-parse --is-inside-work-tree、git branch --show-current、git status --porcelain、git remote -v 检查仓库状态、当前分支、未提交改动与远程信息。
  2. 分支创建:按上下文采用命名约定,规格为 spec/[id]-[name],实现为 feature/[id]-[name],迁移为 migrate/[from]-to-[to],重构为 refactor/[scope]。
  3. 提交生成:采用 <type>(<scope>): <description> 格式,类型包括 feat、fix、docs、refactor、test、chore,并附带 Co-authored-by 署名。
  4. PR 创建:使用 gh pr create 生成规格 PR 或实现 PR,包含文档清单、审查清单、测试计划等模板内容。

使用方式:在 /start:specify、/start:implement、/start:refactor 等流程中调用,开始时检查分支并建议创建对应分支,各阶段完成后生成提交,完成时创建 PR。分支创建、未提交改动处理与 PR 创建均通过 AskUserQuestion 提供选项。

限制与安全原则:保留 main/master 历史,不强制推送;除非明确要求,不修改 git 配置;操作前检查仓库状态;破坏性操作前创建备份。常见错误包括非 git 仓库、分支已存在、存在未提交改动、未配置远程、未安装 gh,技能会给出降级方案。