SuperAPI AI 工具集

commit

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:该技能用于指导 AI 助手按最佳实践创建原子化 Git 提交,强调“尽早提交、频繁提交、一个提交只处理一件事”。

主要能力:

  • 分支安全:禁止直接提交到 main/master;若当前在 main/master,则根据暂存与未暂存变更推导描述性功能分支名并自行创建,例如 git switch -c fix-descriptive-name;名称不明确时用环境中的提问工具确认。
  • 原子提交:每个提交代表一个逻辑变更,便于代码审查、安全回滚、清晰历史与 git bisect 调试。粒度建议:一个 bug 一个提交、一个功能组件一个提交、一个重构方面一个提交;若需用“and”描述不相关变更、diff 过长或涉及 3 个以上不同目的文件,应拆分。
  • 提交信息格式:简短摘要不超过 50 字符,使用祈使语气、首字母大写、结尾不加句号,具体明确;必要时补充详细说明(改了什么、为什么、影响),可加 Co-authored-by 署名。
  • 关联 Issue:用 Fixes #N、Closes #N 或 Resolves #N 自动关闭;部分进展用 Part of #N 仅关联不关闭;无对应 issue 则不添加关键字。
  • 文学编程项目:存在 .nw 文件时绝不提交生成的 .py/.tex 文件,只提交 .nw 源文件,必要时用 git reset HEAD <file> 取消暂存。
  • 预提交检查清单:确认分支正确、单一逻辑变更、提交信息清晰、相关变更齐全、无无关变更、无生成文件被暂存。

使用方式:技能会读取当前分支、git status、暂存与未暂存 diff、最近提交等上下文,据此判断变更是否原子;原子则暂存相关文件并用多行提交信息提交,非原子则说明拆分理由并询问先提交哪部分。

适用场景:日常 Git 提交、需要规范提交历史的项目、文学编程项目。

限制:资料未提供具体安装方式、收费信息或平台支持范围;实际行为依赖当前环境可用的工具与提问机制。