TeyvatGuide/.trae/rules/git-commit-rules.md

Git Commit 规则

核心规则

1. 原子提交：每个 commit 只包含一个主题的变更，不同主题的变更应分成多个 commit
2. 分步提交：分步执行 git add <文件路径> 再 git commit -m "<emoji> <描述>"
3. 单一 emoji：每条提交只使用一个 emoji，位于开头
4. Unicode 格式：使用 Unicode emoji 图标（如 ✨），不要纯文本（如 :sparkles:）
5. 中文描述：以动词开头，一行不超过 100 字符
6. 禁止 type: 声明：不要使用 ✨ feat: xxx 格式

提交格式

<emoji> <描述>

原子提交原则

每个 commit 应该只关注一个主题，如果一次修改涉及多个方面，应该拆分成多个 commit：

✅ 正确的提交方式

# 提交 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 类型注解规范"

❌ 错误的提交方式

# 不要将不同主题的变更混在一个 commit 中
git add src/components/viewpost/vp-overlay-image.vue .trae/skills/typescript-standards/skill.md
git commit -m "♻️ 重构组件并更新 TypeScript 规范"  # ❌ 包含两个主题

拆分指南

场景	拆分方式
代码重构 + 文档更新	分成两个 commit
功能开发 + Bug 修复	分成两个 commit
多个组件修改	按组件拆分 commit
代码修改 + 配置文件	分成两个 commit
功能开发 + 样式调整	分成两个 commit

Emoji 速查

类别	Emoji	场景
新增	✨	新功能
新增	🎨	代码结构/格式
新增	📝	文档
修改	🐛	Bug 修复
修改	🩹	小修复/补丁
修改	⚡️	性能优化
修改	♻️	重构
修改	💄	UI/样式
删除	🔥	删除代码/文件
删除	⚰️	删除死代码
依赖	➕	添加依赖
依赖	➖	删除依赖
依赖	⬆️	升级依赖
部署	🚀	部署
部署	📦	编译/打包
数据库	🗃️	数据库变更
安全	🔒	安全问题
架构	🏗️	架构变更
体验	🧑‍💻	开发体验
进行中	🚧	进行中工作

示例

✨ 添加用户个人页面跳转功能
🐛 修复角色生日判断逻辑
🩹 补充首页 mini 参数处理
♻️ 重构数据库操作为事务模式
⚡️ 优化角色列表渲染性能
📝 更新 TypeScript 类型注解规范
🎨 调整组件代码格式