cline指定git commit 流程:cline rules

时间:2026-07-06 08:56:51 来源:互联网

cline指定git commit 流程(cline rules)以下指南详细说明基于Cline的Git提交流程规范,包含规则与操作步骤。

Git操作专属规则(注释部分不生效)

  1. 首先全面分析当前项目的所有代码变更(包括新增、修改、删除的文件及代码内容),明确变更的核心用途与类型
  2. 编写Git Commit Message时,必须遵循<type>: <description>规范,严格使用以下合法tag,禁止自定义未列出的tag:
    1. feat: 新增功能(全新功能开发、业务逻辑新增)
    2. fix: 修复问题(bug修复、异常场景修复、兼容性修复)
    3. test: 测试相关(新增测试用例、修改测试代码、完善测试覆盖)
    4. docs: 文档变更(修改注释、更新README、补充接口文档等非代码变更)
    5. style: 代码格式调整(仅缩进、空格、命名规范优化,无业务逻辑变更)
    6. refactor: 代码重构(无功能新增/删除,仅优化代码结构、解耦、性能优化)
    7. chore: 杂项事务(依赖安装/更新、配置文件修改、构建脚本调整等)
  3. Commit Message描述部分(<description>)要求:
    1. 首字母小写,结尾不加标点符号
    2. 简洁明了,控制在50个字符以内,准确概括代码变更核心内容
    3. 避免模糊描述,需具体指向变更模块或功能
  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操作流程中,若出现异常(如文件未追踪、提交冲突、权限不足等),需清晰反馈异常信息,并给出可行的解决建议

以上即为完整的Git提交流程规范,遵循这些步骤可确保每次代码提交清晰、一致且可追溯。