SuperAPI AI 工具集

managing-git

编程与开发

查看项目

更新于 10-15 16:34

技能介绍

Managing Git 是一个围绕 Git 工作流管理的技能,用于在涉及 Git 操作时提供分支策略、提交规范和拉取请求流程等指导。

用途

当任务涉及分支策略、提交工作流、拉取请求、合并冲突或版本控制问题时触发加载;不涉及 git 操作的任务则跳过。

主要能力

分支策略

提供两种策略说明:

  • GitHub Flow(推荐用于多数项目):main 始终可部署,从 main 创建功能分支,经 PR、评审后合并,合并后部署。
  • Git Flow(用于基于发布的流程):main 仅存放发布版本,配合 release 与 develop 分支及功能分支运作。

提交规范

采用 Conventional Commits 格式:<type>(<scope>): <description>,可附可选 body 与 footer。类型包括 feat(新功能)、fix(修复)、docs(文档)、style(格式)、refactor(重构)、perf(性能)、test(测试)、chore(构建/依赖)、ci(CI 配置)。资料并给出 OAuth 功能与支付网关修复等示例,包含 BREAKING CHANGE 与 Closes #123 的写法。

分支命名

采用 <type>/<ticket-id>-<short-description> 格式,示例:feature/AUTH-123-oauth-login、fix/BUG-456-null-pointer、chore/TECH-789-upgrade-deps。

拉取请求流程

提供 PR 检查清单(遵循约定、测试、无冲突、文档、安全、说明“why”)、PR 模板(Summary、Changes、Testing、Screenshots)以及 PR 体量分级指南(XS <50 行、S 50-200、M 200-500、L 500+ 建议拆分)。

功能开发工作流

以清单形式列出:从 main 创建功能分支、原子提交、rebase 到最新 main、推送并创建 PR、处理评审反馈、批准后合并。

常见与进阶命令

  • 日常:checkout、pull、commit、fetch、rebase、push(已推送分支 rebase 后用 --force-with-lease)。
  • 修复错误:commit --amend、reset --soft/--hard、revert、rebase -i,及非交互方式 fixup + autosquash。
  • 进阶:cherry-pick、bisect、stash push/list/pop。

提交校验

推送前校验:提交信息清晰、类型匹配、无 WIP/临时提交、无密钥凭证、变更原子化;若不通过,推送前用 rebase -i 清理历史。

使用方式

资料以技能文档形式提供工作流指导与命令示例,未提供安装命令或平台集成方式。

适用场景

适用于涉及 Git 分支管理、提交、创建 PR、解决合并冲突及版本控制相关的开发任务。

限制

资料未提供安装方式、支持平台、收费信息以及实际效果说明。