git-commit

# 规范化提交 开始时声明："我正在使用 git-commit skill 生成并提交规范化 commit。" ## 快速开始 1. 查看 `status/diff/log`，确认提交范围与语言风格。 2. 暂存目标文件并展示"将提交列表"。 3. 生成符合 Angular 规范的 commit message。 4. 仅当用户显式传入 `push=true` 时才 push，默认不 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` / `upload` / `download` / `bucket` / `rs` - `cdn` / `fop` - `sandbox` / `sandbox-template` - `user` / `account` - `ali` / `aws` - `tools` / `share` / `m3u8` - `cmd` / `common` 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=true` 时**才执行 push： - `git push` - 或 `git push -u origin <current-branch>` - 未传入 `push=true` 时，跳过 push 步骤 ## 提交前检查提醒 提交代码前提醒用户确认已通过： - `make test` — 单元测试 - `make lint` — 静态检查 - `gofmt -s -w .` — 代码格式化 ## 关键约束 - 不要使用 emoji 在 commit message 中 - 不要在 commit message 中包含 AI 辅助工具相关信息 - 不要添加 "Generated with" 或 "Co-Authored-By: AI" 等内容 - 不要使用 `--force` 或 `--delete` 等危险 push 选项 - 不要在用户未显式传入 `push=true` 时自动 push ## 输出模板 ```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 为准。