git-commit

name: git-commit description: 遵循 Angular 规范生成 git commit 消息。在用户请求创建 commit、写 commit message 或暂存并提交时使用。典型场景：改完代码要提交前、或要求按 Angular 规范写 message 时。 argument-hint: "<附加上下文(可选)> [push=true]" allowed-tools: - Bash(git add:) - Bash(git branch:) - Bash(git commit:) - Bash(git diff:) - Bash(git log:) - Bash(git status:) - Bash(git push:*)

规范化提交

开始时声明："我正在使用 git-commit skill 生成并提交规范化 commit。"

快速开始

1. 查看 status/diff/log，确认提交范围与语言风格。
2. 暂存目标文件并展示"将提交列表"。
3. 生成符合 Angular 规范的 commit message。
4. 提交后如有上游分支则 push。

何时不要使用（Do NOT use）

• 工作区无待提交变更。
• 用户仅请求代码分析/评审，不需要提交。
• 用户明确要求仅生成建议，不执行 git commit。

触发样例与非样例

• 应触发：
• "帮我按 Angular 规范提交这些改动。"
• "写一个 commit message 并 push。"
• 不应触发：
• "review 这个 PR 有没有问题。"
• "分析下这个报错根因。"

使用示例

# 基本提交
git-commit 修复上传逻辑

# 提交并 push
git-commit push=true

预检查命令

git status --short
git diff HEAD
git branch --show-current
git log --oneline -10

消息规范

Header：<type>(<scope>): <summary>

Type：

• feat 新功能
• fix 缺陷修复
• docs 文档改动
• refactor 重构
• perf 性能优化
• test 测试相关
• chore 杂项维护
• style 代码格式调整

Scope 建议值（本项目常用）：

• storage / storagev2 / auth / cdn / pili / rtc / sms / linking / qvs
• iam / media / audit / sandbox
• client / conf / reqid
• internal / examples

Summary 规则：祈使句、现在时、首字母小写、不加句号。

Body 规则：

• docs 可省略，其他类型建议必须有
• 至少说明"为什么改"与"影响范围"
• 非 docs 类型时，body 至少 20 个字符
• 单段 body 不超过 3 行，保持简洁

Footer（按需）：

• BREAKING CHANGE: ...
• Fixes #123 / Closes #456

语言规则

• 参考最近 10 条提交语言。
• 近期中文为主则用中文；近期英文为主则用英文。

执行流程

1. 先确认提交文件列表。
2. 执行 git add（按文件名添加，避免 git add -A）。
3. 展示 commit message 草案并确认。
4. 执行 git commit。
5. 如有上游分支则 push：
   • git push
   • 或 git push -u origin <current-branch>

提交前检查提醒

提交代码前提醒用户确认已通过：

• make unittest — 单元测试
• make staticcheck — 静态检查
• gofmt -s -w . — 代码格式化

如果是生成代码相关修改，还需确认已运行 make generate。

关键约束

• 不要使用 emoji 在 commit message 中
• 不要在 commit message 中包含 AI 辅助工具相关信息
• 不要添加 "Generated with" 或 "Co-Authored-By: AI" 等内容
• 不要使用 --no-verify 跳过 hooks

输出模板

已提交: <commit-hash>
标题: <type(scope): summary>
分支: <branch>
Push: 成功/失败/未执行

失败回退

• 工作区无变更：输出 git status 结果，提示无可提交内容。
• git commit 失败（hook 报错）：输出完整报错，建议修复后重试，不跳过 hook。
• git push 失败（远端冲突）：输出报错，建议先 pull/rebase 再重试。

验收标准（统一）

• 输入前提：参数与上下文可解析；缺省参数按 skill 默认值执行，并在输出中注明。
• 产出要求：按 skill 约定的输出模板给出结果，并包含关键证据（命令、路径、链接或日志摘要）。
• 通过判定：主流程步骤已完成且无阻塞；若有未完成项，必须明确标注影响范围与下一步。
• 默认策略（非交互）：需要确认但用户未及时响应时，采用"推荐默认值/最小风险项"继续；需要交互选择时优先推荐项。
• 阻塞升级：遇到权限、凭证、外部依赖缺失时立即停止该步骤，输出"阻塞点 + 已尝试 + 需要用户提供的信息"。

系统规范（AGENTS.md）

执行本 skill 时同时遵守 AGENTS.md 中的系统规范；与本 skill 冲突时以本 skill 为准。