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