SuperAPI AI 工具集

git-commit-workflow

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:为仓库设计并执行 Conventional Commits 提交信息与暂存规范,指导如何编写提交信息、暂存文件、分组变更及关联议题。

主要能力:提供标准格式 type(scope): description,含可选正文与页脚;列出 feat、fix、docs、style、refactor、test、chore、perf、ci 等类型;给出议题引用规则(Fixes #N、Closes #N、Refs #N、跨仓库 owner/repo#N);强调祈使语气、首行不超过 72 字符、小写类型与范围、谦逊事实性表达。

使用方式:提交前先确认工作树仅含自己的改动,运行 git status --porcelain;可用 /git:coworker-check 检测同仓库其他会话预暂存的文件。推荐用脚本收集上下文:bash "${CLAUDE_PLUGIN_ROOT}/skills/git-commit-workflow/scripts/commit-context.sh",加 --with-issues 可获取开放议题。暂存时逐文件执行 git add <path>,用 git diff --cached 复核,再以 git commit -m 提交;多行信息用 heredoc 或 git commit -F <file>。批量按子目录提交时,应写成一次性脚本(如 /tmp/commit-loop-<slug>.sh)而非内联链式命令,脚本内用 ; 或换行分隔 git add 与 git commit,避免 git add -A、git add . 等宽泛暂存。

适用场景:编写提交信息、暂存文件、逻辑分组变更、自动检测关联议题、为 release-please 生成按插件/包/文档的独立提交。

限制:该技能侧重规范与流程指导,实际创建提交应使用 git-commit;页脚规则见 git-commit-trailers;议题自动链接见 github-issue-autodetect;PR 标题格式见 github-pr-title。提交在 main 分支进行并推送到远程特性分支,分支模式见 git-branch-pr-workflow。批量循环中途失败时已完成的提交不会回滚,需按 git status 恢复。