用途:Standalone Commits 关注提交的“边界”与“顺序”两方面,目标是让每个提交在同一分支历史中的那个位置上都能被单独审查。它适用场景包括规划提交波次、暂存变更,以及判断某个提交是否过于庞杂。
主要能力:文档给出“独立提交”的定义——提交可以依赖分支中更早的提交,但不应需要后续提交来解释、编译、测试或证明其合理性。它提供一句式提交主张(本提交改变什么、带来什么结果、原因是什么),以及六项验收检查:可审查、可构建、完整、聚焦、可审计、可回滚。还给出拆分与合并的启发式规则、常见反模式(如预告式提交、重构中隐藏行为、搭便车清理),以及提交信息应命名结果而非实现细节。
使用方式:暂存流程建议先查看完整 diff,写下提交主张,只暂存能证明该主张的文件与代码块,用 git diff --staged 复查,必要时运行聚焦验证,然后提交。文件能清晰对应主张时优先按文件暂存,单文件含多种关注点时使用代码块暂存。依赖排序的详细波次流程见 references/splitting-into-ordered-waves.md。
限制:资料未提供具体安装命令、代码示例细节、支持的平台或收费信息。该技能不要求每个提交必须微小,也不要求每个提交在没有同分支更早提交时仍有用;大型生成或机械性变更不必强行拆成噪声。提交信息格式引用 git 技能中的约定式提交规范。