SuperAPI AI 工具集

conventional-git

通用与其它

查看项目

更新于 10-16 08:44

技能介绍

用途:为 GitHub 与 GitLab 项目提供 Conventional Commits v1.0.0 的分支命名、worktree 命名与提交信息规范,使工具能自动生成变更日志、执行 SemVer 版本递增并按关注点过滤历史。

主要能力:分支命名格式为 <type>/[issue-]<description>,全小写、仅用连字符,除 / 外不用特殊字符,如 feat/user-authentication、fix/87-login-race-condition;有 issue 编号时前置,描述控制在 50 字符内,类型需与实际工作匹配,分支名中不得出现 worktree。worktree 是本地检出目录,不进入远端,放在 .claude/worktrees/ 下,目录名把分支的 / 替换为 -,如 git worktree add .claude/worktrees/feat-user-authentication feat/user-authentication;创建前先运行 git worktree list 复用已有 worktree,保持单一分支范围,分支合并后删除并执行 git worktree prune。提交信息格式为 <type>[optional scope]: <description>,可选 body 与 footer;类型含 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert,其中 feat 对应 MINOR、fix 对应 PATCH。规则包括:主题行不超过 72 字符、使用祈使语气、首字母不大写、结尾不加句号、body 前空一行、破坏性变更用 ! 或 BREAKING CHANGE: footer、revert 提交应在 body 中包含 This reverts commit <hash>.,且不得添加 Claude 或任何 AI 智能体的署名与 Co-authored-by。

使用方式:按上述格式创建分支与提交;在 footer 中使用 close、fix、resolve 等关键词(不区分大小写)自动关闭 issue,如 Closes #42、Closes owner/repo#99、Resolves #101、Closes group/project#42,合并到默认分支时触发,也适用于 PR/MR 描述。squash 合并时 PR/MR 标题会成为提交信息,需先确保标题符合规范。

适用场景:需要统一提交历史、自动生成变更日志与版本号的 GitHub、GitLab 项目。

限制:资料未提供该技能的安装方式、收费、平台支持范围与效果数据。