feat: commit every modified submodules on task complete

Author: MonkeyCode-AI

.ai-ready/rules/git-submodule-check.md

@@ -1,6 +1,6 @@
 # Git Submodule Check Rule
 
-在执行任何开发任务之前，必须先检查并加载所有的 Git Submodules。
+在用户与模型首次对话时，必须先检查并加载所有的 Git Submodules。
 
 ## 执行时机
 

.ai-ready/rules/submodule-commit-workflow.md

@@ -0,0 +1,127 @@
+# Submodule Commit Workflow Rule
+
+当在 Git Submodule 内做了改动时，提交前需要在每个有改动的 submodule 中分别切出新的分支，然后分别 push 每个 submodule。
+
+## 触发条件
+
+当准备提交代码时，检测到以下条件：
+1. 项目包含 Git Submodules（存在 `.gitmodules` 文件）
+2. 有一个或多个 submodule 内存在未提交的改动
+
+## 检查 Submodule 状态
+
+使用以下命令检查 submodule 是否有改动：
+
+```bash
+git submodule foreach 'git status --porcelain'
+```
+
+如果输出不为空，说明对应的 submodule 有改动。
+
+## 执行步骤
+
+### 1. 识别有改动的 Submodules
+
+```bash
+git submodule foreach --quiet 'if [ -n "$(git status --porcelain)" ]; then echo $name; fi'
+```
+
+### 2. 对每个有改动的 Submodule 执行以下操作
+
+#### 2.1 进入 Submodule 目录
+
+```bash
+cd <submodule-path>
+```
+
+#### 2.2 创建新分支
+
+分支命名规则与主项目一致，参考 `auto-create-branch-on-master.md`：
+
+```
+YYMMDD-(feat|fix|chore|refactor)-xxxxx-xxxx-xxxx
+```
+
+示例：
+```bash
+git checkout -b 260204-feat-update-component
+```
+
+#### 2.3 提交改动
+
+```bash
+git add .
+git commit -m "<commit message>"
+```
+
+#### 2.4 Push 到远程
+
+```bash
+git push -u origin <branch-name>
+```
+
+#### 2.5 返回主项目目录
+
+```bash
+cd -
+```
+
+### 3. 更新主项目的 Submodule 引用
+
+在所有 submodule 都提交并 push 后，回到主项目：
+
+```bash
+git add <submodule-path>
+git commit -m "chore: update submodule <submodule-name> reference"
+```
+
+## 完整示例
+
+假设项目有一个名为 `libs/common` 的 submodule，今天是 2026 年 2 月 4 日，修改了其中的组件代码：
+
+```bash
+# 1. 进入 submodule
+cd libs/common
+
+# 2. 创建新分支
+git checkout -b 260204-feat-update-component
+
+# 3. 提交改动
+git add .
+git commit -m "feat: update button component styles"
+
+# 4. Push 到远程
+git push -u origin 260204-feat-update-component
+
+# 5. 返回主项目
+cd -
+
+# 6. 更新主项目的 submodule 引用
+git add libs/common
+git commit -m "chore: update submodule libs/common reference"
+```
+
+## 多个 Submodule 的情况
+
+如果有多个 submodule 都有改动，需要依次对每个 submodule 执行上述步骤：
+
+```bash
+# 列出所有有改动的 submodules
+git submodule foreach --quiet 'if [ -n "$(git status --porcelain)" ]; then echo $name; fi'
+
+# 对每个 submodule 分别执行：创建分支 → 提交 → push
+# 最后统一更新主项目的引用
+```
+
+## 注意事项
+
+- 每个 submodule 的分支名应该与其改动内容相关，而非简单复制主项目的分支名
+- 确保 submodule 的远程仓库有推送权限
+- 如果 submodule 的远程仓库需要创建 Pull Request，请在 push 后创建对应的 PR
+- 主项目的 submodule 引用更新应该在所有 submodule 都成功 push 后再进行
+- 如果某个 submodule push 失败，需要先解决问题后再继续
+
+## 相关规则
+
+- [auto-create-branch-on-master.md](./auto-create-branch-on-master.md) - 分支命名规范
+- [git-submodule-check.md](./git-submodule-check.md) - Submodule 初始化检查