Skip to content

qiniu/go-sdk / .agents/skills/git-commit

git-commit

Verified

遵循 Angular 规范生成 git commit 消息。在用户请求创建 commit、写 commit message 或暂存并提交时使用。典型场景:改完代码要提交前、或要求按 Angular 规范写 message 时。

规范化提交

开始时声明:"我正在使用 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 为准。

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall