用途:创建治理检查点提交,保存进行中的工作状态。命令会分析仓库全部改动、校验 .gitignore,并生成与变更请求(CR)关联的格式化提交。
用法:/checkpoint-commit [CR-XXXX] [summary]。两个参数均可选;未提供时命令会自动检测 CR ID 并生成摘要。
工作流程:1)上下文检测,从参数、分支名(如 dev/CR-XXXX)或 docs/cr/ 最近修改文件中确定 CR ID,无法确定时必须向用户确认;2)分析改动,检查已暂存、未暂存和未跟踪文件,无改动则报告并停止;3)更新 .gitignore,排除临时文件、构建产物、生成内容和 IDE 文件,检测到超过 50 个未跟踪文件时须先确认;4)撰写摘要,未提供时根据 diff 生成一句话摘要,提交信息主题为 checkpoint(CR-xxxx): {summary},正文用要点说明改动与原因;5)git add -A 暂存全部改动;6)执行 git commit 创建检查点提交;7)报告提交哈希、操作摘要和包含的文件列表。
安全规则:禁止执行破坏性 Git 操作(git reset、git rebase、git commit --amend、git push --force);必须保留全部工作不丢失数据;操作须幂等可重复运行;暂存前必须校验 .gitignore。
适用场景:需要按变更请求留痕、保存阶段性进度的 Git 仓库治理流程。限制:依赖 Git 环境与 CR 标识约定;未提供 CR ID 且无法自动检测时需人工确认;其余平台与收费信息暂未提供。