SuperAPI AI 工具集

atomic-commits

编程与开发

查看项目

更新于 10-16 06:00

技能介绍

Atomic Commits 是一个面向编码智能体的技能,核心目标是让代码改动以小而聚焦的增量推进,使每次提交都是原子的,每个 PR 都能在一次评审中看完。

用途

该技能适用于实现功能、修复缺陷、重构代码,或进行任何多步骤代码改动的场景。它通过约束提交与 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 时给出提醒。

使用方式

该技能以技能形式提供,来源为 thoughtbot/atomic-commits-plugin,页面地址为 https://www.skills.sh/thoughtbot/atomic-commits-plugin/atomic-commits。资料中未提供具体的安装命令或调用步骤,暂未提供。

适用场景

适合需要智能体参与多步骤代码改动的开发流程,尤其是希望保持提交历史清晰、PR 易于评审、每个增量都可部署的团队或个人。

限制

资料未说明该技能支持的平台、依赖的智能体框架、钩子的具体触发条件与配置方式,也未提供收费、价格或效果方面的信息,这些内容暂未提供。