SuperAPI AI 工具集

sl-commit

通用与其它

查看项目

更新于 10-15 20:05

技能介绍

用途:在 Sapling SCM 中按 Conventional Commits 规范创建格式良好的提交,并辅助判断是否需要拆分提交。

主要能力:用 sl status 检查仓库状态;用 sl add 添加未跟踪文件;用 sl diff 查看待提交改动;分析 diff 判断是否存在多个独立逻辑变更,若存在则建议拆分为多个较小提交;为每个提交生成符合 conventional commit 格式的提交信息。

使用方式:常用命令包括 sl status、sl diff、sl add <files>、sl commit -m "<message>"。Sapling 与 Git 的关键差异:没有暂存区,提交会直接包含所有待处理改动;sl amend 会自动变基后代提交;每个提交会成为独立的 Phabricator diff。其他命令:sl commit -A 添加未跟踪文件并提交;sl amend 修订当前提交(自动变基后代);sl amend --to COMMIT 将改动修订到栈中指定提交。

适用场景:使用 Sapling 进行版本控制、希望提交信息规范统一、需要将混杂改动拆分为多个聚焦提交的开发者。

限制与注意:Windows 上需使用 sl.exe 的完整路径,避免与 PowerShell 内置的 Set-Location 别名 sl 冲突;若配置了 pre-commit 检查需遵循;建议保持提交小而聚焦,因为每个提交会成为独立的 Phabricator diff;可自由使用 sl amend,Sapling 会自动处理变基;需标注 AI 辅助代码的作者归属。