
# Git 操作专属规则(# 为注释,不生效)
1. 首先全面分析当前项目的所有代码变更(包括新增、修改、删除的文件及代码内容),明确变更的核心用途与类型
2. 编写 Git Commit Message 时,必须遵循 : 规范,严格使用以下合法 tag,禁止自定义未列出的 tag:
- feat: 新增功能(全新功能开发、业务逻辑新增)
- fix: 修复问题(bug 修复、异常场景修复、兼容性修复)
- test: 测试相关(新增测试用例、修改测试代码、完善测试覆盖)
- docs: 文档变更(修改注释、更新 README、补充接口文档等非代码变更)
- style: 代码格式调整(仅缩进、空格、命名规范优化,无业务逻辑变更)
- refactor: 代码重构(无功能新增/删除,仅优化代码结构、解耦、性能优化)
- chore: 杂项事务(依赖安装/更新、配置文件修改、构建脚本调整等)
3. Commit Message 描述部分()要求:
- 首字母小写,结尾不加标点符号
- 简洁明了,控制在 50 个字符以内,准确概括代码变更核心内容
- 避免模糊描述,需具体指向变更模块或功能
4. 执行 Git 操作前,先读取项目根目录的 .gitignore 文件,严格过滤被忽略的文件/目录
5. 仅对非忽略的、有有效代码变更的文件执行 git add 操作(避免添加空文件、临时文件、缓存文件)
6. 完成 git add 后,使用上述规范的 Commit Message 执行 git commit 操作,确保提交成功
7. git commit 操作完成后,主动询问用户:“是否需要立即执行 git push 操作,将本地提交推送到远程仓库?”
8. 若用户回复“是”“需要”等肯定性表述,立即执行 git push 操作;若用户回复否定或无明确指示,不执行 git push 操作
9. 整个 Git 操作流程中,若出现异常(如文件未追踪、提交冲突、权限不足等),需清晰反馈异常信息,并给出可行的解决建议