用途:该技能提供一条 Git 提交流水线,帮助开发者把工作过程中的改动按原子单元逐个提交,并规范提交信息的撰写与校验。技能说明中指出,应在工作过程中运行此流水线,而不是留到任务结束时才做;工作的第一步之前应先规划好提交单元。
主要能力与流程分段:
一、勘察改动。通过 git diff 与 git diff --cached 查看已跟踪文件的未暂存与已暂存改动,未跟踪文件需由 git status --short 的 ?? 标记识别并显式指定路径暂存。用两种测试划分边界:拆分测试(把改动切成两块后各自是否能构建并通过测试)与工作种类测试(一个单元只做一类工作,新代码与接入调用方的接线属于两个单元)。
二、规划单元与排序。为每个单元指定类型并按顺序提交:样式类、重构类、修复类、功能类;文档、测试与杂项可放在任意位置;先提交样式与重构,以保持改动行为的提交干净。依赖顺序优先于类型顺序,测试随所属单元一并提交。
三、质量门禁。确认本次会话中是否对改动文件运行过 lint、测试或构建并已通过;若未运行则运行适用的检查,检查失败先修正,不提交有缺陷的代码。门禁结果不应写入提交信息。
四、提交循环。逐个单元执行:暂存(git add 需显式路径,不使用交互式 git add -p;撤销用 git restore --staged <file>)、起草信息(写入 /tmp/commit-msg.txt)、自查(git diff --cached 核对是否只含目标单元、有无调试代码或敏感数据)、校验、提交(先以引用块展示完整信息,再执行 git commit -F /tmp/commit-msg.txt,不传 --no-verify)。校验命令为 node ${CLAUDE_PLUGIN_ROOT}/scripts/validate-commit-message.js --file /tmp/commit-msg.txt,并按项目配置附加相应标志;校验器只提示不阻断,即便打印 ERROR 退出码也可能为 0,须修正所有 ERROR 后再提交。
五、核验。最后以单独命令查看 git log --stat -3 与 git status,展示新提交主题、分支状态与仍未提交的改动。
项目配置与限制:项目 CLAUDE.md 中的 <validator-args> 与 <extra-instructions> 需遵守,后者优先级最高。破坏向后兼容的提交正文以 BREAKING: 开头并给出迁移路径;可优先采用分阶段的迁移系列。流水线不测量拆分测试的断言,错误拆分可能在历史中留下中断的提交,后续 git bisect 才会发现;删除代码、改签名或移动符号时需更谨慎。git add / git commit 中途出现权限提示意味着授权过期,需重新调用该技能。资料未提供价格、平台支持范围等事实。