SuperAPI AI 工具集

git-user

办公与效率

查看项目

更新于 10-16 07:23

技能介绍

用途:在创建或更新分支、变基、撰写提交、准备评审、以及验证与 Git 历史和 PR 集成相关的 CI 预期时触发,指导维护线性 Git 工作流。

核心原则与规则:线性历史为强制要求;main 受保护且不可变;优先变基而非合并;由人工评审的 Pull Request 把关合并。禁止在 main 上 push 或 force-push;禁止将 main 合并进功能分支(不产生合并提交);仅允许快进合并进 main,且由人工在 GitHub 手动执行;已推送的功能分支变基后,必须使用 --force-with-lease 推送。

主要步骤:使用 Git CLI;从 main 创建分支;经常基于远端 main 变基,如 git fetch && git rebase origin/main 或 git pull --rebase origin main;在本地解决冲突并运行相关检查与测试;创建一个或多个原子提交,按技术领域或业务关注点分组。首次推送用 git push -u origin <branch>,变基或改写历史后用 git push --force-with-lease。

约定:分支命名为 feature/<topic>、fix/<topic>、chore/<topic>;提交信息使用祈使动词,保持小而原子,复杂变更补充描述性正文。

提交重写策略:默认不重写历史。仅当 AI 的改动使原有提交信息失真或不准确时才允许重写(改写、压缩、重排),例如信息不再描述代码、同一逻辑变更被拆散、多条提交描述同一工作、提交引入的改动后来被撤销、或评审清晰度需要。当信息仍准确、提交本已干净原子、仅为了“更美观”或需改动 main 时,禁止重写。

限制:资料未提供具体安装方式、平台支持、收费、价格或效果说明。