CLAUDE.md:新增「及时提交」规则到提交规范

每完成一个可独立验证的工作单元(bug 修复 / 配置变更 /
文档更新 / 依赖升级 / M 里程碑子项)就主动提议提交,
BuildProject 通过 / 关键路径手测通过即立即提议。

理由:项目处于 greenfield 重写阶段,commit 颗粒越小
回滚成本越低;CLAUDE.md / docs 与 git log 一起构成
项目记忆,commit message 是"为什么"的第一现场。
This commit is contained in:
joywayer
2026-06-21 20:03:14 +08:00
parent beb05ab451
commit 1da2884358
+8
View File
@@ -136,3 +136,11 @@ H5 页面通过特定的 JavaScript 协议初始化桥并注册自己的 handler
- 不在未授权情况下执行 `git push``git reset --hard``git rebase``git push --force` 等不可逆操作 - 不在未授权情况下执行 `git push``git reset --hard``git rebase``git push --force` 等不可逆操作
- 涉及桥接接口名 / 参数字段名 / 数据结构的改动,提交信息必须明示 "契约影响" 并附 `docs/H5-Native-Contract.md` 对应章节 - 涉及桥接接口名 / 参数字段名 / 数据结构的改动,提交信息必须明示 "契约影响" 并附 `docs/H5-Native-Contract.md` 对应章节
- 工作树有多个不相关改动时,按职责拆 commit,不混提 - 工作树有多个不相关改动时,按职责拆 commit,不混提
- **及时提交**:每完成一个可独立验证的工作单元(一项 bug 修复 / 一处配置变更 / 一次文档更新 / 一次依赖升级 / 一个 M 里程碑的子项),就应在工作树干净时主动提议提交。理由:
- 项目处于 greenfield 重写阶段,commit 颗粒越小越容易在出错时二分定位 / 回滚
- 长时间不提交容易让 pbxproj / Info.plist / SDK 二进制等结构化文件互相耦合,git diff 失去可读性
- CLAUDE.md / docs 与 git log 一起构成项目记忆——commit message 是"为什么"的第一现场,比事后补文档更可信
- 主动提议提交的时机判定:
- 改动已通过最小验证(BuildProject 通过 / 关键路径手测通过 / 单测通过)→ 立即提议
- 工作树还有其它无关待提交内容 → 先帮用户分类、按职责拆 commit,**不混提**
- 用户未明确同意前不直接执行 `git commit`,但应当**清晰地告诉用户"现在适合提交了"**,并附上建议的 commit message