AgentSkillsCN

github-batch-commits

分析已暂存与已修改的文件，按功能进行分组，并引导批量提交。当用户说“提交到 Github”、“提交到 GitHub”、“push to GitHub”，或拥有来自多个功能的众多已暂存文件，且希望按功能进行提交时，可选用此工具。

SKILL.md
--- frontmatter
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：获取变更状态

bash
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

分组输出格式：

markdown
## 功能 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 下的编码乱码。

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

对每个分组依次执行：

bash
# 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/*.tsapi
pages/*.tsx页面名（如 chat、messages）
supabase/*.sqlschema / migration
lib/utils/*.tsutils
types.ts随主功能（若仅类型变更可单独 chore(types)）
.env*.exampleconfig

跨目录关联

若 pages/ChatDetail.tsx 与 lib/api/messages.ts 同时修改，且语义相关（如聊天功能），应归入同一分组。

无法明确分组时

  • •询问用户该文件属于哪个功能
  • •或单独成组，用 chore 或 fix 提交

检查清单

提交前：

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

提交后：

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

参考