github-batch-commits

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：校验分组

对每个分组：

• 文件是否语义相关（同一功能）
• 是否遗漏依赖（如 API 变更但未包含调用方）
• 是否混入无关文件（需移到其他分组）

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): 添加谷歌登录"

对每个分组依次执行：

# 1. 若文件已全部暂存，先 unstage 全部
git reset HEAD

# 2. 仅暂存当前分组文件
git add <file1> <file2> ...

# 3. 提交（使用 Conventional Commits 风格，英文描述）
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 提交

---

检查清单

提交前：

• 已运行 git status 获取完整变更
• 分组结果已展示给用户确认
• 每组文件语义一致
• 提交信息符合 Conventional Commits

提交后：

• git status 无遗漏
• git log -3 查看最近提交是否清晰

---

参考

• 分组示例与边界情况见 reference.md