SuperAPI AI 工具集

git-commit

编程与开发

查看项目

更新于 11-11 22:14

技能介绍

git-commit 是一个面向 AI 智能体的 Git 提交技能,适用于需要把本地改动整理成清晰提交记录的场景。

用途:把磁盘上的改动按“工作单元”分别 commit,并明确不执行 push。它强调每次提交只包含一个独立的逻辑改动,避免把无关修改混在一起。

主要能力与流程:

  1. 环境确认:用 Get-Location 与 git branch --show-current 确认当前目录和分支,用 git config user.name 获取用户名,用于写入提交信息。
  2. 保存处理:除已确认无未保存编辑的情况外,若当前运行环境提供保存功能则使用;若没有保存功能、保存失败或无法确认完成,则按磁盘内容继续,并在最终报告中说明未保存编辑可能未被反映。技能明确禁止为此添加保存扩展或辅助脚本。
  3. 变更检查:保存后执行 git status --short、git diff、git diff --cached。没有变更则以“Nothing to commit”结束。需要确定本次提交范围;若混入无关或归属不明的改动而无法判断,应先向用户确认。
  4. 分单元暂存:对每个工作单元显式指定路径执行 git add -- <目标路径>,随后用 git diff --cached 确认暂存内容仅属于该工作单元,并运行 git diff --cached --check。若 add 或检查失败则停止并报告;若残留无关的已暂存内容,不自行取消,而是停止并确认。
  5. 提交与报告:检查通过后执行 git commit -m '<提交信息>',确认成功后再处理下一个工作单元;相互独立的改动应拆成不同提交。完成后报告提交 ID 与剩余改动,且不执行 push。

提交信息格式:采用 Conventional Commits,格式为 <type>(<scope>): <subject> - <user.name>,例如 feat(auth): 登录功能追加 - <user.name>、fix(api): 修复超时错误 - <user.name>、docs(readme): 更新安装步骤 - <user.name>。

适用场景:需要让 AI 智能体在本地仓库中自动整理并提交改动,同时保持提交粒度清晰、提交信息规范、不误推送远端。

限制:资料未说明其支持的具体平台、安装方式、收费模式或与其他工具的集成细节,这些内容暂未提供。技能本身不执行 push,也不负责新增保存用扩展或脚本。