git-workflow · diff
git:20260414.3583839 to git:20260617.b8acb5f
89 added, 23 removed. Audit A to A.
---
name: git-workflow
description: Git 工作流自动化 - 智能分支管理、提交信息生成、PR 创建
---
# Git 工作流助手
## 触发条件
当用户要求提交代码、创建分支、发起 PR、整理 commit、rebase 时激活此技能。
## 工作流程
- ### 智能提交信息
- 1. 分析 `git diff` 内容
- 2. 自动生成符合 Conventional Commits 规范的提交信息
- 3. 格式：`<type>(<scope>): <description>`
- 4. type 选择：feat/fix/docs/style/refactor/test/chore/perf
-
- ### 分支管理
- - `feat/功能名` — 新功能
- - `fix/问题描述` — Bug 修复
- - `hotfix/紧急修复` — 紧急修复
-
- ### PR 描述生成
- 自动生成包含以下内容的 PR 描述：
- - 变更摘要
- - 改动文件列表
- - 测试情况
- - 关联 Issue
-
- ## 命令参考
+ ### 第 1 步：分析当前状态
```bash
- # 查看当前状态
git status
git log --oneline -10
git diff --staged
+ ```
+ 识别暂存区的变更内容、涉及的文件和改动类型。
- # 分支操作
- git checkout -b feat/xxx
- git rebase -i HEAD~n
+ ### 第 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 描述模板
+
+ ```markdown
+ ## 变更摘要
+ 简要描述本次 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