git-auto-commit

Git 自动提交规范

当用户明确要求“提交 / commit / 推送 / 把改动提交到仓库”时，必须遵循以下规范自动生成 commit message 并执行提交。

决策顺序与优先级

1. 只在用户明确要求时提交：未被要求时，不要主动提交或推送。
2. 与 changeset 的前后顺序：若用户同一请求里同时要求“添加 changeset + 提交”，必须先生成 changeset 文件，再执行本 skill（保证 changeset 被包含在提交中）。
3. 安全优先：提交前必须检查暂存内容，避免把密钥、token、私钥等敏感信息提交到仓库；如发现疑似敏感信息，先停止并提示用户处理。

提交流程

1. 执行 git status 查看当前变更
2. 执行 git add . 暂存文件（如果用户没有特别说明，默认提交所有变更文件）
3. 执行 git diff --cached --name-only 获取已暂存的关键变更文件列表
4. 通过 git 命令查看关键变更文件的内容后生成符合规范的 commit message（避免凭空猜测）
5. 执行 git commit -m "<message>" 提交
6. 执行 git push 推送到远端（默认行为，除非用户明确说"不 push"或"不推送"）

推送规则

• 默认推送：提交完成后自动执行 git push
• 跳过推送：仅当用户明确表示"不 push"、"不推送"、"只 commit"等类似意图时，才跳过推送步骤
• 推送失败处理：如果推送失败，提示用户可能的原因（如需要先 pull、无远端分支等）

Commit Message 规范

规范来源优先级

1. 优先读取项目根目录下的 .commitlintrc.xx 配置文件

   • 如果存在该配置文件，严格遵循其中定义的规范
   • 读取可用的 commit type 列表及对应的 emoji
   • 读取 scope 的允许值及其他提交规则

2. 如果没有 .commitlintrc.xx 配置文件

   • 参考 commit-message-convention.md 中的默认规范
   • 使用标准的 conventional commits 格式

输出要求（必须满足）

1. 提交信息可追溯：message 必须与暂存的变更内容匹配，不允许与实际改动不一致
2. 最小惊扰：默认提交全部变更；若用户只想提交部分文件，必须按用户指定范围暂存
3. 遵循仓库规范：存在 commitlint 配置时必须严格遵循，否则按默认规范生成

使用场景

1. 用户要求提交代码
2. 任务完成后需要保存变更
3. 需要生成规范的 commit message