SuperAPI AI 工具集

atomic-commits

编程与开发

查看项目

更新于 10-16 07:29

技能介绍

Atomic Commits 是一个用于指导 AI 编程智能体进行代码提交与 PR 组织的技能,来源于 thoughtbot/thoughtbot-dev。它的核心理念是:以小而聚焦的增量工作,每个提交都应是原子的,每个 PR 都应能一次评审完成。

用途 该技能适用于实现功能、修复缺陷、重构代码,或进行任何多步骤代码改动的场景。它帮助智能体在编码过程中保持提交粒度合理,避免一次性堆积大量改动。

主要能力与规则 原子提交标准:每个提交必须满足三点——通过 CI(测试、linter、构建全部为绿色)、可部署(应用处于有效状态)、不引入死代码(没有不可达代码、未使用导入或半连接的功能)。

一次提交,一类工作:提交被划分为三种类型——重构(在不改变行为的前提下调整代码结构)、功能(行为变更本身)、清理(删除旧代码、更新文档)。如果提交信息里需要用“and”连接,就应当拆分。

PR 大小:目标约为每个 PR 200 行。如果更大,需要寻找接缝,将重构与功能作为独立的 PR 分别提交,每个 PR 都可独立合并和部署。

智能体行为 在编码前规划原子步骤:先重构,再功能,最后清理。 每个原子步骤完成后立即提交,不要累积。 选择性暂存(使用 git add --patch 或指定文件)。 当分支 diff 接近 200 行时,打开一个 PR,并在后续 PR 中继续。

钩子 该技能包含一个 PostToolUse 钩子(hooks/check-diff-size.sh),在 Edit/Write 操作后监控 diff 大小,并在需要提交或打开 PR 时发出提醒。

适用场景 适合需要 AI 智能体参与多步骤代码改动、并希望保持提交历史清晰、PR 易于评审的开发工作流。

限制 资料未提供该技能的具体安装方式、支持的平台、收费情况或价格信息,这些内容暂未提供。