atomic-commit
Installation
SKILL.md
Atomic Commit
核心目标是让每笔提交都具有可独立说明的业务意义,并能整笔直接回滚。提交边界由完整业务结果、交付完整性和回滚边界共同决定,不追求最小、最细。
原子性标准
- 业务意义:完成该 commit 后,用户、角色或系统获得一项完整能力,或者产生一个可观察的业务结果。提交应能用业务语言说明价值,而不是只描述修改了哪些文件或技术层。
- 完整交付单元:共同完成同一业务结果所需的实现、测试、文档、配置、迁移和生成文件放在同一 commit。该 commit 在其依赖基线之上能够完整成立、整体验证,不依赖剩余未提交改动。
- 可直接回滚:可以通过整笔回滚该 commit 撤销这次交付,无需挑选 hunk、同时回滚无关提交或手工拼接恢复状态;回滚后不会留下明显残缺状态。
- 业务边界优先于粒度:不按文件数、改动量、技术层次或约定式提交类型拆分。只要内容共同形成一个完整业务结果并共享验证与回滚边界,就作为一个 commit。
- 按业务结果拆分:只有形成不同且各自完整的业务结果,并且能够分别验证、交付和回滚时才拆分。
流程
使用已加载的 CONTEXT 术语与 RULE。尚未加载则按项目知识协议执行;知识不可用时继续并如实说明。