| name | github-batch-commits |
| description | Analyzes staged and modified files, groups them by feature, and guides batch commits. Use when the user says "提交到Github", "提交到 GitHub", "push to GitHub", or has many staged files from multiple features and wants to commit by feature. |
GitHub 分批提交 (Batch Commits by Feature)
触发词：用户说「提交到Github」「提交到 GitHub」「push to GitHub」等时，执行本流程。
强制许可规则（必须遵守）
- 在执行任何
git commit / git push 前，必须先获得用户明确许可（例如“确认提交”“可以 push”）。
- 若用户仅表达“想提交”或“看看变更”，默认只做分析与分组，不得直接提交/推送。
- 每一批提交前都需要再次确认；未经许可，不得继续下一批提交。
- 若用户未明确授权，流程止步于“分组建议 + 提交信息草案”。
适用场景
- 多开对话完成不同功能后，暂存区积累大量文件
- 需要按功能分批提交，保持提交历史清晰
- 需要检查每个功能涉及的文件是否完整、无遗漏
执行流程
Step 1：获取变更状态
git status
区分：
- 已暂存 (staged)：
Changes to be committed
- 未暂存 (modified)：
Changes not staged for commit
- 未跟踪 (untracked)：
Untracked files
Step 2：按功能分组文件
使用以下启发式规则对文件分组（优先级从高到低）：
| 规则 | 说明 | 示例 |
|---|
| 目录归属 | 同目录下文件通常属于同一功能 | lib/api/messages.ts + lib/api/gemini.ts → api |
| 功能前缀 | 文件名或路径含功能关键词 | add_agent_type_*.sql → agent 功能 |
| 依赖关系 | 互相 import 或引用 | ChatDetail.tsx ↔ lib/api/messages.ts → 聊天功能 |
| 类型聚合 | 同类型变更 | *.sql → schema；*.tsx → UI |
分组输出格式：
## 功能 A：xxx
- path/to/file1.ts
- path/to/file2.tsx
## 功能 B：yyy
- path/to/file3.sql
- path/to/file4.ts
Step 3：校验分组
对每个分组：
Step 4：分批提交
提交信息规范（强制）
Commit messages must be in English only.
提交信息必须使用英文，禁止使用中文，以避免 Windows/PowerShell 下的编码乱码。
Commit message rules:
- Language : English only (no Chinese)
- Format : <type>(<scope>): <short description>
- Types : feat | fix | refactor | chore | docs | style | test
- Description: present tense, lowercase (except proper nouns)
Good: "feat(auth): add Google sign-in"
Bad : "feat(auth): 添加谷歌登录"
对每个分组依次执行：
git reset HEAD
git add <file1> <file2> ...
git commit -m "feat(scope): short description in English"
注意：提交信息须使用英文，不得使用中文，以避免乱码。若确需非 ASCII 字符，可使用 git commit -F <UTF-8 文件>，详见 reference.md。
提交信息格式（Conventional Commits）：
| 类型 | 用途 | 示例（英文） |
|---|
feat(scope) | 新功能 | feat(auth): add Google sign-in |
fix(scope) | 修复 | fix(api): handle null response |
refactor(scope) | 重构 | refactor(utils): simplify date helpers |
chore(scope) | 配置、依赖、脚本 | chore(config): update env example |
docs(scope) | 文档 | docs(readme): update deploy steps |
Step 5：重复直至完成
每完成一批提交后，再次运行 git status 确认剩余文件，继续分组提交。
分组启发式细则
常见项目结构对应
| 路径模式 | 建议 scope/功能名 |
|---|
lib/api/*.ts | api |
pages/*.tsx | 页面名（如 chat、messages） |
supabase/*.sql | schema / migration |
lib/utils/*.ts | utils |
types.ts | 随主功能（若仅类型变更可单独 chore(types)） |
.env*.example | config |
跨目录关联
若 pages/ChatDetail.tsx 与 lib/api/messages.ts 同时修改，且语义相关（如聊天功能），应归入同一分组。
无法明确分组时
- 询问用户该文件属于哪个功能
- 或单独成组，用
chore 或 fix 提交
检查清单
提交前：
提交后：
参考
