用途:该技能用于在 build 过程中规范 Git 版本控制操作,产出整洁、可拆分审查的提交历史,之后可进入 verify-workflow-review 审查。入口是 build 过程中需要提交代码或创建分支;出口是清晰的提交历史。前置需加载 CANON.md。
主要能力:提倡主干开发(分支存活少于 2 天、合并前 rebase 到最新 main、小 PR 优先);强调原子提交(一个改动一个提交,每提交约 100 行,超过 300 行考虑拆分);要求描述性提交信息,格式为 <type>: <简短摘要>,类型含 feat/fix/refactor/test/docs/chore/perf/security,说明写 why 而非 what;强调关注点分离(格式化、重命名/移动、行为变更分开提交);采用 Save Point 模式频繁提交并 push;可用 git worktree 隔离不相关工作;提供提交前检查命令:git diff --staged、git diff --staged --check、npm test;列出 git bisect、git log -- path、git blame -L、git grep 等调试工具。
使用方式:创建隔离工作区可用 git worktree add -b feature/x ../project-feature-x main,完成后 git worktree remove 清理;误 staged 密钥用 git reset HEAD <文件> 取消;已提交则需清理历史。
限制与注意:不适用于只读历史、查看状态或解释 Git 概念,也不适用于明确要求不提交或不改历史的场景。禁止 git add -A / .、禁止 force-push 到共享分支、禁止用 --no-verify 跳过钩子、禁止提交 .env、密钥、node_modules 或编译产物;合并冲突不得用 --theirs 整块解决;force-push 到 main/master 属重写共享历史。不确定改动来源时先询问人类协作方。技能文档中的具体行数、时间与损失数值为原资料给出的经验性说明。