SuperAPI AI 工具集

commit

编程与开发

查看项目

更新于 10-16 00:23

技能介绍

用途:把「写一条符合约定的提交信息并交给 git commit」这件事标准化。它先解析提交规范(subject 形状)与 trailer 策略,再按规范生成标题与正文,最后用 stdin 送入 git commit。

主要能力:一是规范解析阶梯,依次查用户全局、团队已跟踪与个人覆盖的 source-control.md 层,若都没有则看项目自身 CLAUDE.md、AGENTS.md、规则或 commit-msg 钩子,最后回落 Conventional Commits 默认(11 种类型,不含 security)。二是暂存前四项前置检查,避免误覆盖已暂存的删除、重命名旧侧、目录下未跟踪文件与部分暂存拆分,只对干净路径执行 git add。三是提交前格式化并重新暂存,随后运行 exec-bit-check.sh --fix -- <路径> 修正新增 shebang 文件的权限位(须在格式化之后)。四是在调用 git 前用正则预检标题形状,并提供可操作的合规示例。

使用方式:用 Bash 工具以 <<'EOF' heredoc 管道调用 git commit -F -,加 --cleanup=verbatim;仅在 trailer_policy 要求时加 --trailer。刻意不使用 git add -A,也不把消息写入 .git/<TEMP>.txt。

限制与注意:规范由项目 commit-msg 钩子最终把关,预检只检查形状;trailer 中的模型名需自行确认真实名称,无法自动填充;Windows 下 core.filemode=false 时 pathspec 提交会丢失可执行位,此类文件应改用普通索引提交并用 git ls-tree 核对;其余未在资料中说明的细节暂未提供。