diff --git a/CLAUDE.md b/CLAUDE.md
index 7f4ffa0..5d85404 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -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