Skip to content

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

git-commit

Verified

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

FileKindSize
SKILL.mdskill md4.4 KB
---
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 有没有问题。"
- "分析下这个报错根因。"

## 使用示例

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

# 提交并 push
git-commit push=true
```

## 预检查命令

```bash
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

## 输出模板

```text
已提交: <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: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated 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: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall