3.2 KiB
3.2 KiB
name, description
| name | description |
|---|---|
| commit-convention | 为本仓库生成符合团队规范的 Git 提交信息，并在用户要求提交代码时执行完整提交流程。用于 git commit、提交代码、写 commit message、创建提交、push 前整理提交等场景；Agent 代提交时必须使用 [Ai] 标记并写清业务变更。 |
Git 提交规范（Agent 代提交）
触发条件
满足任一条件，必须先加载本 skill，再执行 git add / git commit：
- 用户明确要求：提交、commit、git commit、保存提交、push 前先 commit 等
- 用户规则中的「committing-changes-with-git」流程已启动
未获用户明确授权时，不得执行 commit。
Agent 代提交：标记规则（强制）
由 Cursor Agent 发起的提交，必须在 subject 前加 [Ai]：
[Ai] <type>(<scope>): <subject>
<body 可选：业务背景、影响范围、关联 Bug>
type：feat|fix|refactor|style|perf|chore|docs|test|build|ciscope：模块/页面，如benefits、mine、community、player- 可在正文末尾追加 trailer（可选）：
Co-Authored-By: Cursor <noreply@cursor.com>
用户本人手动提交、且明确说明「人工提交」时，建议使用 [Human]；Agent 不要替用户假标 [Human]。
Subject 质量（强制）
提交说明必须让人一眼看懂改了什么业务或修了什么问题。
必须做到
- 先并行执行：
git status、git diff（含 staged）、git log -5 --oneline了解风格与变更范围 - subject 用完整语义描述，优先中文；可中英混用 scope
- 多文件、多模块时：一条 commit 只包同一业务目标；若混杂无关改动，先询问是否拆分
- body 写：原因、用户可见变化、风险点（如有）
严禁（subject 不得仅为或等同于）
test、修改、update、fix、xxx、111、wip、temp、提交、save、纯标点、纯数字、单字
示例
# ✅
[Ai] feat(benefits): 新增七日签到弹窗与连续签到奖励展示
[Ai] fix(player): 修复横屏切换后 HLS 首帧黑屏
[Ai] refactor(mine): 签到任务列表抽离 useSignTask composable
# ❌
[Ai] fix: 修改
[Ai] feat: test
修改播放器
111
提交流程（与 user rule 对齐）
git status+git diff+git log（可并行）- 根据 diff 撰写符合本规范的 message（HEREDOC 传
-m） - 只
git add与本次任务相关的文件 - 不得提交
.env、密钥、凭据类文件；若用户在 staged 中含此类文件，警告并排除 git commit后git status确认成功- hook 失败时：不要
commit --amend，修 message 后新建 commit - 除非用户明确要求，否则不
git push
输出给用户
提交完成后简要说明：
- commit hash（若有）
- 本次纳入的文件范围
- message 摘要（一行）
与本地 Hook / CI 的关系
本 skill 约束 Agent 行为。若仓库后续接入 husky + commitlint 或 CI，以仓库脚本校验为准；Agent 仍须预先满足 [Ai] 与 subject 质量，避免 hook 拒绝。