git-workflow logo

git-workflow

Git 工作流自动化 - 智能分支管理、提交信息生成、PR 创建

SKILL.md

Full skill instructions

Git 工作流助手

触发条件

当用户要求提交代码、创建分支、发起 PR、整理 commit、rebase 时激活此技能。

工作流程

第 1 步:分析当前状态

git status
git log --oneline -10
git diff --staged

识别暂存区的变更内容、涉及的文件和改动类型。

第 2 步:确定提交类型

根据变更内容自动判断 type:

  • feat — 新功能
  • fix — Bug 修复
  • docs — 仅文档变更
  • style — 格式调整(不影响逻辑)
  • refactor — 重构(非新功能、非修复)
  • test — 测试相关
  • perf — 性能优化
  • chore — 构建/工具链变更

第 3 步:生成提交信息

格式遵循 Conventional Commits:<type>(<scope>): <description>

第 4 步:分支管理与 PR

根据变更类型创建分支并生成 PR 描述。

第 5 步:历史整理

交互式 rebase 整理提交历史,合并琐碎提交。

输出格式

Commit Message 模板

<type>(<scope>): <简短描述>

<body: 详细说明变更原因和内容>

<footer: 关联 Issue、Breaking Changes>

示例

feat(auth): 添加 OAuth2 第三方登录支持

集成 Google 和 GitHub OAuth2 登录,用户可绑定已有账号。
新增 /api/auth/oauth/callback 端点处理回调。

Closes #123

PR 描述模板

## 变更摘要
简要描述本次 PR 做了什么。

## 变更类型
- [ ] 新功能 (feat)
- [ ] Bug 修复 (fix)
- [ ] 重构 (refactor)
- [ ] 文档 (docs)
- [ ] 其他 (chore)

## 改动文件
| 文件 | 变更说明 |
|------|---------|
| src/auth/oauth.ts | 新增 OAuth2 认证逻辑 |
| src/routes/auth.ts | 新增回调路由 |

## 测试情况
- [ ] 单元测试通过
- [ ] 集成测试通过
- [ ] 手动验证完成

## 关联 Issue
Closes #123

## 截图/录屏(如适用)

分支命名规范

类型格式示例
新功能feat/<功能名>feat/oauth-login
Bug 修复fix/<问题描述>fix/login-timeout
紧急修复hotfix/<紧急描述>hotfix/security-patch
文档docs/<内容>docs/api-guide
重构refactor/<范围>refactor/auth-module

注意事项

  • 提交信息使用中文或英文均可,但同一个仓库应保持一致
  • 每个提交应保持原子性,只做一件事
  • PR 描述应足够详细,让 reviewer 无需查看代码即可理解变更
  • rebase 前确保本地改动已提交或暂存,避免丢失工作
  • 不要对已推送到远程的公共分支执行 rebase