SKILL.md
只读
名称
commit
描述
用于每次请求提交更改或草拟提交信息。创建带有问题引用的 Sentry 风格约定式提交。
Sentry 提交信息
提交前
git branch --show-current
如果分支是 main 或 master,除非用户明确要求直接提交,否则创建一个功能分支。重新检查分支,如果仍然是 main 或 master,则停止。
一次提交一个连贯、可独立审查的更改。
信息规则
使用:
<类型>(<范围>): <主题>
<可选正文>
<可选页脚>
- 范围是可选的。对于破坏性变更,在
:前添加!。 - 使用祈使句、现在时写主题;首字母大写,省略末尾句号,控制在 70 个字符以内。
- 每行不超过 100 个字符。
- 仅在有用时使用正文。解释更改了什么以及为什么,包括之前的行为或动机(如果有助于理解)。
- 绝不包含客户或组织名称、用户邮箱、支持工单内容、机密或 PII。改为描述技术症状。
允许的类型:feat、fix、ref、perf、docs、test、build、
ci、chore、style、meta、license 和 revert。
使用 ref 表示无行为变更的重构,style 表示无逻辑变更的格式化,meta 表示仓库元数据。
页脚
Fixes <issue>合并时关闭一个问题。Refs <issue>链接一个问题但不关闭。- 对于破坏性变更,添加
BREAKING CHANGE: <impact>。
创建提交
对段落和页脚使用单独的 -m 参数。绝不要在提交信息中放入字面 \n 序列或打开交互式编辑器。
git commit -m "fix(api): 处理用户端点中的空响应" \
-m "当用户 API 发现已删除的账户时返回 404。" \
-m "Fixes SENTRY-5678"






