SuperAPI AI 工具集

commit

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:在目标仓库中完成一次语义化 Git 提交。技能负责从不可变证据撰写提交信息,ai-commit 负责确定性的准备、提交、索引协调与推送机制。所有命令需在目标仓库工作目录执行,不要额外调用 git status、git log 或 git diff。

主要能力:支持 Conventional Prefix 或 Natural Language 两种信息格式,格式由仓库配置决定;可用 --natural 或 --conventional 做一次性覆盖。--all 捕获全部工作区与索引改动;--staged 精确捕获当前索引;--push 请求提交后推送,--rebase 允许在推送前将落后分支变基到已获取的上游;--close 追加 Closes #N;--finding 追加 Finding-ID;--squash 将合并基之后的提交压缩为一个净差异提交,需干净树与索引、非默认分支,且与 --all、--staged、--push 冲突。

使用方式:先运行 ai-commit prepare [--all | --staged] [--natural | --conventional] --diff full 获取事务 ID 与完整 diff,再分析并撰写主题、可选正文和尾部段落,最后运行 ai-commit commit <transaction-id> -m '<subject>' [-m '<body>'] [-m '<trailers>'] [--push --rebase]。事务幂等,中断后可重试同一事务 ID。

限制:默认模式需列出本会话编辑的仓库相对文件路径,重命名需包含新旧路径;--all 不接收显式路径,--staged 不接收路径与基线排除。推送目标需按 PR head 解析,禁止强推。squash 模式仅在用户明确要求时进入,且不得传 --push。绕过标志如 --no-verify、--no-gpg-sign 需先阅读失败恢复参考,不作为首次默认。资料未提供具体安装命令、收费与平台信息。