| name | git-commit-push |
| description | 标准化 Git 工作流：检查状态、commit、可选 push。区分当前对话修改与全部变更。仅当用户明确说出"使用 git-commit-push"或"启动 git-commit-push"时触发。不适用于任何隐式场景。 |
Git 工作流
标准化 Git 工作流，区分 commit/push 和 当前/全部 变更范围。
触发约束
此 skill 仅通过显式调用触发。
⛔ 不触发的场景
- 用户提到"commit"、"push"、"git"等但未提及 git-commit-push
- 用户说"帮我commit"（这是日常指令，不触发本 skill）
- 用户未显式引用 @git-commit-push
✅ 触发条件
必须同时满足：
- 用户明确说出"使用 git-commit-push"或"启动 git-commit-push"，或显式引用 @git-commit-push
- 用户提供了明确需求或上下文
核心原则
默认行为
| 参数 | 默认值 | 触发条件 |
|---|
| push | 不 push | 用户明确说"push"才执行 |
| commit 范围 | 当前对话修改 | 用户明确说"全部"或"所有变更"才 commit 所有 |
场景矩阵
| 用户指令 | commit 范围 | 是否 push |
|---|
| "帮我commit" | 当前对话修改 | 不 push |
| "commit then push" | 当前对话修改 | push |
| "commit 所有变更" | 所有变更 | 不 push |
| "commit 所有，然后push" | 所有变更 | push |
| "检查git，帮我commit" | 当前对话修改 | 不 push |
执行流程
Step 1: 检查 Git 状态
运行并展示：
git status
git diff --stat
输出中区分：
- 当前对话修改：agent 使用 Edit/Write/Bash 创建/修改/删除的文件
- 其他变更：用户手动修改、其他工具产生的变更
Step 2: 确认范围
根据用户指令确定范围：
| 用户指令 | 操作 |
|---|
| 未指定范围（如"帮我commit"） | 只 commit 当前对话修改 |
| "全部" / "所有变更" | commit 所有未提交文件 |
| 有歧义 | 询问用户确认 |
Step 3: 展示即将提交的文件
列出即将提交的文件：
## 即将提交
**范围**: {当前对话修改 / 所有变更}
| 文件 | 状态 | 来源 |
|------|------|------|
| `path/to/file.py` | modified | agent Edit |
| `path/to/another.py` | new file | agent Write |
| `path/to/config.json` | modified | 用户手动修改 |
**敏感文件检查**:
- ✅ 无 .env、credentials 等敏感文件
- ⚠️ 发现敏感文件: {文件列表} — 需用户确认是否提交
Step 4: 执行 commit
生成 commit message：
- 基于变更内容生成（非机械总结）
- 格式：
{type}({scope}): {brief description}
- type: feat/fix/refactor/docs/test/chore
执行 commit：
git add {文件列表}
git commit -m "..."
Step 5: 执行 push（可选）
默认不 push。
用户明确说"push"时才执行：
git push origin {当前分支}
push 前展示目标分支，确认无误。
如何识别"当前对话修改的文件"
| 来源 | 标记 |
|---|
| agent 使用 Edit 工具修改的文件 | 记录为当前修改 |
| agent 使用 Write 工具创建的文件 | 记录为当前修改 |
| agent 使用 Bash 创建/删除的文件 | 记录为当前修改 |
| 用户手动编辑的文件 | 不属于当前对话修改 |
| 其他工具（如 IDE）产生的变更 | 不属于当前对话修改 |
实际操作：agent 在对话中追踪自己操作的文件路径，commit 时只 add 这些文件。
反模式
| 反模式 | 正确做法 |
|---|
| 默认 push | 用户明确说"push"才 push |
| 默认 commit 所有变更 | 用户明确说"全部"才 commit 所有 |
| 跳过状态检查 | 必须先展示 git status |
| commit 用户未确认的敏感文件 | 发现敏感文件需询问 |
| commit message 与变更不符 | 基于实际变更生成 |
完成检查清单
标记 Git 操作完成前确认：
