SuperAPI AI 工具集

commit

编程与开发

查看项目

更新于 11-17 16:37

技能介绍

该技能用于在 git 提交代码时遵循 Sentry 提交信息规范,适用于用户要求提交代码、准备提交信息或保存变更,以及需要带 conventional commit 结构和 issue 引用的场景。

使用前先检查当前分支:git branch --show-current。如果位于 main 或 master,必须先创建功能分支,除非用户明确要求提交到 main 且服务端允许直接推送;用户请求不能绕过受保护分支规则,远端拒绝直接更新时应走仓库要求的 Pull Request 流程。不要询问用户是否创建分支,直接创建。使用 create-branch 技能创建分支,完成后再次检查分支是否已改变;若仍在 main 或 master(如用户中止创建),停止,不得提交。

提交格式为 <type>(<scope>): <subject>,后接可选正文和页脚;提交头必需,scope 可选,所有行不超过100字符。类型包括 feat(新功能)、fix(缺陷修复)、ref(重构,无行为变化)、perf(性能优化)、docs(文档)、test(测试增改)、build(构建系统或依赖)、ci(CI 配置)、chore(维护任务)、style(代码格式,无逻辑变化)、meta(仓库元数据)、license(许可变更)。主题行使用祈使、现在时,首字母大写,结尾无句号,最长70字符。正文解释做了什么和为什么,不解释怎么做,包含变更动机,必要时对比旧行为。页脚用 Fixes GH-1234、Fixes #1234、Fixes SENTRY-1234、Refs LINEAR-ABC-123 等模式引用 issue;Fixes 在合并时关闭 issue,Refs 仅关联不关闭。若变更主要由编码智能体生成,在页脚添加 Co-Authored-By: Claude noreply@anthropic.com,且这是提交中唯一应出现的 AI 参与标记,不得在主题、正文或其他位置添加“Generated by AI”“Written with Claude”等语句。

文档包含简单修复、带 scope 的功能、重构、破坏性变更和 revert 的示例格式。原则是每次提交为单一稳定变更、可独立审查、提交后仓库处于可用状态。限制包括:仅在任务明确匹配上述范围时使用;直接提交到 main 的指令仍从属于服务端分支保护和必需检查;输出不能替代环境特定验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。