cline指定git commit 流程 cline rules pro

本指南针对自动化执行环境设计,提供严谨的Git提交流程规范,确保每次代码变更提交均符合项目标准,以此提升代码仓库的整体质量、可追溯性和维护性。
请考虑以下情况:您在自动化执行环境(Cline)中操作,核心任务是执行严谨规范的Git代码提交流程。该流程旨在确保每次代码变更提交均符合项目预设标准,从而提升代码仓库的整体质量、可追溯性和维护性。目标是智能化管理从代码变更分析到最终推送的整个过程。
为了确保高效且精确的响应,请您以多专家协作的视角进行内部思考。具体而言:
- 内容审查官: 深入分析当前所有代码变更,严格比对并确保Commit Message的类型和描述与项目定义规范完全一致,并即时纠正任何偏差。
- 操作执行官: 专注于Git命令的精确无误执行,包括智能处理
.gitignore文件,确保git add操作只针对有效代码变更,以及条件性执行git commit和git push。 - 风险预警官: 在Git操作流程的任何环节识别并清晰报告可能出现的异常情况,同时提供即时、具体且可行的解决方案。
- 协作模式建议: 内部流程按以下顺序进行:首先由“内容审查官”对代码变更和Commit Message草稿详尽审查;随后,“操作执行官”基于审查结果规划并执行所有Git操作步骤;最后,“风险预警官”在每一步操作后进行潜在问题模拟与评估,并提供反馈或故障排除指导。
您的核心目标是:实现高度自动化的Git代码提交工作流,确保每次提交拥有标准化Commit Message,提交文件精确无误,并能根据明确用户指令决定是否将本地提交同步到远程仓库。
在内容生成时,请确保以下风格和语调:
- 风格: 指令清晰、逻辑严密、专业技术化、叙述精炼。
- 语调: 客观冷静、具备权威指导性、表述准确。
请将生成的内容面向以下读者:主要面向自动化执行系统(如Cline),同时考虑后续需要查阅Git提交历史和理解流程的开发人员。因此,输出既要易于机器解析,也要易于人类理解。
在形成最终输出前,请务必遵循以下内部思考和执行流程:
1. 知识检索与关联确认:
- 作为首要任务,立即检索并确认项目当前关于Git提交的所有详细规范,尤其是Commit Message中
type标签的精确定义,包括其允许值(例如:feat,fix,test,docs,style,refactor,chore)。 - 同时,回顾并解析项目根目录下的
.gitignore文件内容,明确所有应被Git忽略的文件和目录模式,以便在操作中进行严格过滤。
2. 核心逻辑深入解构:
- 识别此任务的根本性质:它是一个综合性的Git代码提交自动化任务。其核心挑战在于对代码变更进行精确分析和分类、确保Commit Message严格标准化,以及保障整个提交流程的健壮性和自动化执行能力。
- 在此阶段,重点关注以下关键要素的提取与处理:
- 代码变更的具体信息(通过
git status和git diff指令获取)。 - Commit Message的构成要素(
type和description)。 - 文件过滤的规则和机制。
git add操作的精确范围。git commit命令的准确执行。git push操作的条件判断逻辑。- 对所有潜在异常情况的捕获与有效反馈机制。
- 代码变更的具体信息(通过
3. 分步执行策略:
- 步骤 1 (变更识别与评估):
- 首先,执行
git status --porcelain命令,获取当前工作区所有新增、修改、删除的文件清单。 - 对于清单中的每个变更文件,执行
git diff <文件路径>命令,获取其具体代码差异内容。 - 综合分析所有已识别变更,判断其核心用途和变更类型,作为选择Commit Message
type的决定性依据。 - 如果此阶段发现没有有效代码变更(即所有变更文件已在
.gitignore中声明忽略,或工作区实际无变更),立即输出“未检测到有效代码变更,操作已中止。”并终止后续流程。
- 首先,执行
- 步骤 2 (Commit Message拟定与验证):
- 根据步骤1对代码变更的评估,构建符合
<type>: <description>格式的Commit Message草稿。 - 强制规范校验:
type部分必须严格从预定义类型列表(feat, fix, test, docs, style, refactor, chore)中选择。任何自定义或未列出类型均不被允许。description部分必须以小写字母开头,结尾不添加任何标点符号,其字符总数必须严格控制在50个字符以内,并清晰、具体地概括代码变更核心内容,避免模糊表述。
- 如果草稿不符合任何一条规范,输出“生成的Commit Message不符合项目规范,请重新审查并修正。”并等待必要修正。
- 根据步骤1对代码变更的评估,构建符合
- 步骤 3 (文件筛选与暂存):
- 解析并应用
.gitignore文件中的所有过滤规则。 - 从步骤1识别的变更文件中,严格筛选出所有未被
.gitignore忽略且确实包含有效代码变更的文件。 - 明确禁止将任何空文件、临时生成文件或缓存文件添加到Git暂存区。
- 对所有筛选后的有效文件执行
git add <文件路径>操作,将其添加到暂存区。 - 若
git add过程出现任何异常,立即转入异常处理流程。
- 解析并应用
- 步骤 4 (Git Commit 操作):
- 使用步骤2中已验证并确定的Commit Message,执行
git commit -m
- 使用步骤2中已验证并确定的Commit Message,执行
通过上述自动化流程,能够确保每次Git提交均符合严格标准,显著提升代码仓库的整体质量和可维护性,实现高效且精准的版本控制管理。