SuperAPI AI 工具集

git-commit-only

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:git-commit-only 用于在当前仓库中创建一次聚焦的本地 Conventional Commit,不推送到任何远程。默认在当前分支生成一个提交,分析实际 diff、暂存请求的变更集、根据变更内容生成提交消息,并为非平凡变更编写分段正文,便于审阅者按主题快速了解改动。

主要能力:支持 Conventional Commit 格式,类型包括 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert;破坏性变更可用 ! 或 BREAKING CHANGE: 页脚标注;主题使用现在时祈使句,尽量控制在 72 字符内;非平凡变更要求分段正文,并在运行测试、校验器、钩子或人工验证时加入 Tests: 或本地化等价章节;相关 issue 可在正文或页脚引用,如 Closes #123。

使用方式:按顺序执行工作流。先运行 git status --short 和 git branch --show-current,用 git diff --cached --stat、git diff --cached 查看已暂存差异,未暂存时用 git diff --stat、git diff;需要脚本解析时用 git status --porcelain。暂存时,若用户要求提交全部则运行 git add -A,范围较窄时只暂存该范围,必要时用文件级添加、路径模式或 git add -p,随后重新检查 git status --short。提交消息按仓库现有语言编写,用多个 -m 参数或等效方式保留正文,不使用 --no-verify;钩子或校验失败时修复后重试。最后报告提交哈希、分支、已提交文件摘要和运行的验证,并明确说明未执行推送。

适用场景:用户要求不推送地提交当前工作、从已暂存和未暂存变更创建一个本地提交、用 Conventional Commit 消息在本地保存工作,或需要按功能区域、UI 区域、测试、文档、验证分组的可读提交正文。

限制:不处理提交并推送请求(应使用 git-pushing-fast)、多分支合并流程、强制推送、rebase、squash、amend 或历史重写、创建 PR、发布说明、周报或变更日志生成。禁止推送、修改全局或系统 Git 配置、运行 git reset --hard 或 git checkout -- <file> 等破坏性命令(除非明确要求)、跳过钩子、提交密钥(如 .env、凭据文件、私钥、令牌)。目标仓库或提交范围不明确时应停止并报告阻塞,而非猜测。