Menu
Git workflow 综合指南。Invoke when user wants to make commits, needs commit format guidance, or after completing coding tasks.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | git-workflow |
| description | Git workflow 综合指南。Invoke when user wants to make commits, needs commit format guidance, or after completing coding tasks. |
本技能包含完整的 Git 提交工作流指南，涵盖提交规范和任务完成后的提交流程。
每个 commit 只包含一个主题的变更。如果一次修改涉及多个方面，应该拆分成多个 commit：
# ✅ 正确：拆分成两个独立的 commit
git add src/components/viewpost/vp-overlay-image.vue
git commit -m "♻️ 重构图片浮窗组件拖拽缩放逻辑"
git add .trae/skills/typescript-standards/skill.md
git commit -m "📝 更新 TypeScript 类型注解规范"
# ❌ 错误：不要混在一个 commit 中
git add 文件 1 文件 2
git commit -m "♻️ 重构组件并更新 TypeScript 规范"
<emoji> <描述>
✨ feat(xxx) 这种格式| 场景 | 拆分方式 | 示例 |
|---|---|---|
| 代码重构 + 文档更新 | 分成两个 commit | ♻️ 重构组件 + 📝 更新文档 |
| 功能开发 + Bug 修复 | 分成两个 commit | ✨ 添加功能 + 🐛 修复问题 |
| 多个组件修改 | 按组件拆分 commit | ♻️ 重构组件 A + ♻️ 重构组件 B |
| 代码修改 + 配置文件 | 分成两个 commit | ✨ 实现功能 + 🔧 更新配置 |
| Emoji | 场景 | 示例 |
|---|---|---|
| ✨ | 新功能 | ✨ 添加用户个人页面跳转功能 |
| 🎨 | 代码结构/格式 | 🎨 重构角色卡片组件 |
| 📝 | 文档 | 📝 更新 README |
| 🎉 | 初始项目 | 🎉 初始化项目 |
| ✅ | 测试 | ✅ 添加角色查询单元测试 |
| Emoji | 场景 | 示例 |
|---|---|---|
| 🐛 | Bug 修复 | 🐛 修复角色生日判断逻辑 |
| 🩹 | 小修复/补丁 | 🩹 补充首页 mini 参数处理 |
| ⚡️ | 性能优化 | ⚡️ 优化角色列表渲染性能 |
| ♻️ | 重构 | ♻️ 重构数据库操作层 |
| 💄 | UI/样式 | 💄 调整首页卡片布局 |
| Emoji | 场景 | 示例 |
|---|---|---|
| 🔥 | 删除代码/文件 | 🔥 移除废弃组件 |
| ⚰️ | 删除死代码 | ⚰️ 清理未使用的导入 |
| Emoji | 场景 | 示例 |
|---|---|---|
| ➕ | 添加依赖 | ➕ 添加图表库依赖 |
| ➖ | 删除依赖 | ➖ 移除冗余依赖 |
| ⬆️ | 升级依赖 | ⬆️ 升级 Vue 版本 |
| 🔧 | 配置文件 | 🔧 更新 vite 配置 |
| Emoji | 场景 | 示例 |
|---|---|---|
| 🚀 | 部署 | 🚀 部署生产环境 |
| 📦 | 编译/打包 | 📦 更新构建产物 |
| Emoji | 场景 | Emoji | 场景 |
|---|---|---|---|
| 🗃️ | 数据库 | 🔒 | 安全问题 |
| 📈 | 分析/跟踪 | 🏗️ | 架构变更 |
| 🧑💻 | 开发体验 | 🚸 | 用户体验 |
| 💫 | 动画/过渡 | 🔀 | 合并分支 |
| ⏪ | 回滚 | 🔖 | 版本标签 |
| 🚧 | 进行中 | 💚 | CI 修复 |
| 🚨 | 警告修复 | 👔 | 业务逻辑 |
| 🦺 | 验证 | 🌐 | 国际化 |
| 💥 | 重大变更 | 🍱 | 静态资源 |
| 🏷️ | 类型定义 | 🚚 | 移动/重命名 |
当以下条件满足时，应该提交 commit：
git status
关键原则：原子提交
根据变更类型选择对应的 emoji（见上方 Emoji 选择指南）
单个主题的提交：
git add <文件路径>
git commit -m "<emoji> <描述>"
多个主题的提交（拆分）：
# 提交 1
git add 文件 1
git commit -m "♻️ 重构组件 A"
# 提交 2
git add 文件 2
git commit -m "📝 更新文档"
格式要求：
feat: 这种括号声明好的示例：
✨ 添加用户个人页面跳转功能
🐛 修复角色生日判断逻辑
♻️ 重构图片浮窗组件拖拽缩放逻辑
📝 更新 TypeScript 类型注解规范
错误的示例：
✨ feat: 添加功能 # ❌ 使用了 type 声明
修复了一些 bug # ❌ 没有 emoji
Added new feature # ❌ 没有使用中文
如果用户说"先别提交"或"我自己来提交"，则跳过提交步骤。
如果变更涉及多个方面但不确定如何拆分，应该询问用户：
"这次修改涉及多个方面，您希望我：
- 拆分成多个 commit 提交？
- 还是合并成一个 commit 提交？"
如果提交失败（例如有 lint 错误），应该：
场景：用户要求重构图片浮窗组件并更新 TypeScript 规范
任务完成后，应该这样提交：
# 检查变更
git status
# 提交 1：组件重构
git add src/components/viewpost/vp-overlay-image.vue
git commit -m "♻️ 重构图片浮窗组件拖拽缩放逻辑"
# 提交 2：规范更新
git add .trae/skills/typescript-standards/skill.md
git commit -m "📝 更新 TypeScript 类型注解规范"
# 1. 检查变更
git status
# 2. 添加文件（原子提交）
git add <文件路径>
# 3. 提交（格式：<emoji> <描述>）
git commit -m "<emoji> <中文描述>"
| Emoji | 场景 | Emoji | 场景 |
|---|---|---|---|
| ✨ | 新功能 | 🐛 | Bug 修复 |
| ♻️ | 重构 | ⚡️ | 性能优化 |
| 💄 | UI/样式 | 📝 | 文档 |
| 🎨 | 代码格式 | 🔧 | 配置 |
| 🔥 | 删除 | 🚀 | 部署 |
| ⬆️ | 升级依赖 | 🗃️ | 数据库 |
✨ 添加用户个人页面跳转功能
🐛 修复角色生日判断逻辑
🩹 补充首页 mini 参数&组件参数处理
♻️ 重构数据库操作为事务模式
⚡️ 优化角色列表渲染性能
💄 调整深色模式配色方案
📝 添加组件使用文档
⬆️ 更新依赖版本，修复安全警告
🔧 更新 vite 配置以支持新插件
🚸 统一 UIGF 导出交互，导出前选择导出路径
💫 添加页面转场动画效果
🐛 修复抽卡记录导出为空的问题
🏗️ 引入 Pinia 状态管理
🧑💻 优化热更新加载速度