SuperAPI AI 工具集

aicommit

编程与开发

查看项目

更新于 11-01 16:10

技能介绍

用途:为当前工作区中未暂存的代码改动生成一条可直接使用的 Git 提交信息,帮助开发者快速完成提交说明的撰写。

主要能力:

  • 先阅读项目中的 AGENTS.md,遵循项目通用规范。
  • 使用 git diff 查看未暂存改动;必要时用 git diff HEAD 获取当前分支全部改动的额外上下文。
  • 参考 git log --oneline -40 中的既有提交信息风格。
  • 快速分析改动带来的收益、理由与动机,除非用户另有要求,否则保持快速响应。
  • 输出一条紧凑的单行提交信息,作为用户应使用的提交信息。

格式与规则:

  • 提交信息为一行;必要时可在首行下以“-”开头的无序列表补充重要信息。
  • 当改动与发布说明相关时追加可选的“##”标签;崩溃与内存安全修复标记为“##crash”。
  • 不使用 emoji。
  • 描述用户现在会注意到什么可用或不再出错。
  • 以 Fix、Add、Remove、Keep、Stop、Don't 等直接动词开头。
  • 用几个词点明结果,例如避免在损坏的 bflt 中泄漏重定位、一次性生成 Windows 类型 sdb、修复移位溢出与 ASR 符号扩展。
  • 避免内部设计术语与含糊行话。
  • 使用一条自然语句,长度低于 70 个字符。
  • 输出至少低于 70 列。
  • 参考主分支中已有提交,采用随意的写作风格。

使用方式:在存在未暂存改动的仓库中调用该技能,按上述步骤读取差异与日志,最终得到一条提交信息。

适用场景:需要为当前未暂存改动快速拟定提交信息、并希望与项目既有提交风格保持一致时。

限制:该技能为只读操作,不修改或触碰任何文件;若发现改动不宜合并到主分支,应向用户说明。