DawnMoon1542 Git Smart Commit — 智能提交
1. 核心流程
检查状态 → 分析变更 → 生成 commit message → dry-run 展示 → 用户确认 → 执行提交 → 询问推送
在用户确认之前，不执行任何写入操作。所有分析只读。
提交完成后默认不自动推送；确认工作区状态后主动询问用户是否执行 git push。
2. 确定变更范围
2.1 默认范围
- 当前有任务上下文（agent 正在执行某个具体任务，如"修复登录超时 Bug"）→ 默认仅纳入与当前任务相关的文件变更，从
git status --porcelain中筛选匹配上下文路径和主题的文件。 - 无任务上下文（用户只说"提个 commit"，未附带任何工作说明）→ 默认纳入所有已暂存 + 未暂存的变更。
2.2 用户显式指定范围
用户可通过以下方式覆盖默认范围：
| 表述示例 | 含义 |
|---|---|
| "只提交 src/auth 的变更" | 仅纳入匹配 src/auth* 路径的文件 |
| "排除测试文件" | 排除 *.test.ts、*.spec.ts、tests/ 等文件 |
| "把 .ts 文件和配置文件分开提交" | 按文件类型拆分，分别生成 commit message |
| "把这两个文件一起提交" | 仅纳入用户指定的文件 |
以用户明确指定的范围为准，不额外揣测或扩缩范围。
2.3 前置条件
git status --porcelain
判断：
- 无任何变更 → 输出「工作区干净，无需提交」并结束。
- 仅有未跟踪文件 → 提示用户是否需要
git add，由用户决定。 - 存在已暂存 + 未暂存变更 → 若未指定范围，默认提交所有已暂存 + 未暂存。若已指定范围，仅提交范围内的文件。
2.4 分支与远端状态
git branch --show-current
git status -sb
在 dry-run 展示中附上当前分支名称。
3. 分析变更内容
3.1 变更概览
根据第 2 节确定的范围，对所纳入文件分情况获取 diff：
git diff --cached -- <范围文件> # 范围内已暂存的变更
git diff -- <范围文件> # 范围内未暂存的变更
git diff HEAD -- <范围文件> # 新文件尚未暂存时，用 HEAD 比较
对于范围外的变更，仅展示文件清单（git status 筛选），不纳入分析。
3.2 变更归类
扫描 diff 内容，对每个文件的变更进行归类：
| 类别 | 判定依据 |
|---|---|
| 新增文件 | 全新文件，非已有文件的重命名/移动 |
| 删除文件 | 删除已有文件 |
| 重命名 | 相似内容的新旧文件名 |
| 功能变更 | 新增函数/方法、新增逻辑、新增 API 端点 |
| 修复 | 条件修正、边界处理、异常捕获、逻辑错误修正 |
| 重构 | 变量重命名、提取函数、结构调整（行为不变） |
| 样式 | CSS/样式文件变更、UI 调整 |
| 配置 | package.json、tsconfig、.env、CI 配置等 |
| 依赖 | pnpm add/uv add 产生的锁文件和 package.json 变更 |
| 文档 | .md、注释大量变更、README 更新 |
| 测试 | test/ 或 spec/ 目录、pytest/vi test 相关文件 |
| 删除代码 | 仅删除不再需要的代码 |
| 批量 | 超过 10 个文件的同类型机械变更 |
3.3 关键变更识别
从 diff 中提取以下信息：
- 修改的文件列表及每个文件的核心变更目的
- 新增/删除的函数或方法名称
- 明显的 bug 修复（错误条件修正、异常处理添加）
- 新增的功能模块
重要变更与发布操作
检查数据库结构、已有数据迁移或删除、外部契约不兼容、必需环境配置、部署与外部依赖、服务或运行任务中断、专项公告、旧版本恢复限制。数据库表、字段、约束和索引的实际变化即使自动迁移也须标识；可选配置且默认行为不变、常规构建重启、仅内部调用调整不单独标识。公告独立判断，不能只按技术破坏性判断。不得将未知事项记为“无”。
在范围内 diff、直接调用方和相关需求或设计文档之间复核重要变更，不仅搜索文件名或 commit subject。文档缺失不代表无影响；已撤销的设计不能继续作为事实。若发现文档与代码不符，在 dry-run 中指出，遵守提交分析只读要求，不擅自修改文档。
在 dry-run 的 Commit Message 之前展示“重要变更与发布操作”，列出实际影响、额外操作、公告和恢复限制，并单列待确认问题；无相关事项时简写“已评估，无”。有实际影响时在 commit 正文开头加入同名段落，描述已明确的兼容性与发布要求，不能仅提供文档链接。发布要求属于变更的使用条件，不将未解决问题或环境执行状态写入 commit。只有实际外部契约不兼容时使用 BREAKING CHANGE:，公告或数据库结构变化本身不必改变提交类型。
提醒纳入已有 dry-run 确认，不新增独立确认环节。记录发布要求不代表获准执行迁移、修改服务器配置或发送公告。
4. 生成 Commit Message
类型选择规则：
| 类型 | 使用场景 |
|---|---|
feat |
新增功能、模块、能力、页面 |
fix |
修复 bug、错误行为 |
refactor |
结构调整、代码整理（行为不变） |
test |
新增或修改测试 |
chore |
配置、依赖、构建、工具链变更 |
docs |
文档变更 |
style |
样式/ui变更 |
如果一次提交混合了多种类型，选择占比最大的；如果两种类型占比接近，优先 feat > fix > refactor > 其他。
4.1 基本原则
- 简述写变更的结果，不写变更的过程。
- 一条 commit 覆盖一组逻辑相关的变更；若变更之间无关联，提示用户分开提交。
5. Dry-Run 展示
向用户展示以下内容，不执行任何 git 操作：
=== Git Smart Commit - Dry Run ===
分支：<当前分支名>
范围：<范围说明，如"当前任务相关文件 3 个"或"所有变更 12 个文件"或"排除测试文件后 5 个文件">
待提交文件数：N
范围外未纳入文件（如有）：
?? path/to/outside.ts
重要变更与发布操作：
<实际影响、额外操作、公告、恢复限制与待确认事项；无相关事项时写已评估，无>
Commit Message：
---
<英文类型>: <中文简述>
<中文正文>
---
``
### 5.1 用户确认
向用户询问下一步操作：confirm, edit, cancel
## 6. 执行提交
用户确认后，先将范围内的文件加入暂存区，再提交：
```bash
git add <范围文件列表>
git commit -m "<类型>: <简述>" -m "<正文>"
提交完成后展示结果：
已提交至分支 <branch>：<commit hash 前7位>
6.1 询问是否推送
提交成功后，使用 AskUserQuestions 询问用户是否推送到远端：
push— 执行git pushskip— 不推送，结束流程
6.2 提交失败处理
| 错误 | 处置 |
|---|---|
| 空 commit | 提示工作区无实际变更，不提交 |
| pre-commit hook 失败 | 展示 hook 输出，等待用户处理 |
| 签名/鉴权失败 | 提示用户配置 git user/credential |
7. 完整示例
示例 1：混合变更
用户执行 git smart-commit 后的 dry-run：
=== Git Smart Commit - Dry Run ===
分支：main
范围：当前任务相关文件 4 个
待提交文件数：4
范围外未纳入文件：
?? temp/debug.log
变更概览：
M src/renderer/index.ts (+12, -3) — 去重逻辑
M src/protocol/message.ts (+45, -0) — 新增接口与工具函数
M tests/protocol/message.test.ts (+30, -0) — 测试用例
M tsconfig.json (+1, -1) — 路径别名调整
Commit Message：
---
feat: 消息合并去重，新增 MessageTurn 接口与 mergeTurnSteps
新增 MessageTurn 接口和工具函数，增加按 ID 去重逻辑，补充 mergeTurnSteps 正常与边界测试用例，新增 @protocol 路径别名
---
示例 2：仅修复
=== Git Smart Commit - Dry Run ===
分支：fix/login-timeout
范围：当前任务相关文件 1 个
待提交文件数：1
Commit Message：
---
fix: 修复登录超时不显示错误提示
catch 块中增加错误信息返回逻辑
---
8. 与其他技能的协作
- 与
code-review配合：code-review 完成后，使用本技能将审查修正作为一个整体提交。 - 与
subagent-driven-development配合：子代理返回变更后，使用本技能统一提交。
9. 禁止模式
- 在执行 dry-run 之前直接执行 commit。
- 跳过
git diff分析，仅凭文件名生成 commit message。 - 在一个 commit 中混合多个无关的变更主题。
- 提交空的 commit message。
- 在用户确认前执行任何写操作。