用途:指导如何提交(commit),把改动整理成一次内聚、可审计的 Git 提交。
主要能力与流程:
- 建立 Git 状态:检查分支、当前 Git 操作、已暂存与未暂存改动、未跟踪文件,以及任务或 issue 边界;关键事实不清时先询问。
- 构建提交候选:只暂存直接属于任务的改动,保留无关的已暂存改动;若任务是单一内聚变更则准备一个候选,分组不清时先询问,无合适候选则报告并停止。
- 审计候选:查看完整暂存 diff,检查可能的密钥,运行 git diff --cached --check,创建提交时保留正常 Git hooks。
- 撰写信息:优先匹配近期提交历史,遵守显式信息要求,使用简洁主题,沿用仓库的类型、作用域、语气、长度与标点;仅在解释原因、取舍、约束、副作用或后续跟进时添加正文;有工单则引用,不虚构。
- 创建提交:普通提交用引号 heredoc 传递完整信息:
git commit -F - <<'COMMIT_MSG' type(scope): concise summary COMMIT_MSG
处于活动 Git 操作时走相应续接路径;已知事实表明是对 HEAD 的明显本地跟进时可 amend,事实不清时询问,否则新建提交。 6) 验证结果:检查新提交的 hash、主题、stat 与 git status,报告提交和已运行的检查,确认剩余改动是有意的;提交失败时保留状态供检查,报告失败且不盲目重试。
安全护栏:检查候选改动中是否含凭据、私钥、令牌和本地密钥文件,发现则停止并询问处理方式,且不重复泄露密钥值;保留任务边界之外的改动,改动边界外的已暂存改动前先询问;保持正常 Git hooks 启用。
限制:资料未提供安装方式、平台、收费或价格等信息。