SuperAPI AI 工具集

git-best-practices

办公与效率

查看项目

更新于 10-16 06:50

技能介绍

用途:为代理和开发者提供统一的 Git 操作规范,覆盖提交、分支、PR 与历史管理,适用于结构各异的仓库。

主要能力:始终生效的原则包括先探测再操作(分支、合并、开 PR 前先确定默认分支与生产分支)、约定式提交(type(scope): description)、按文件名显式暂存、用 --force-with-lease 保护共享历史且强推前须经用户确认。代理工作流顺序为:git status 与 git diff HEAD 检查状态、探测分支、按名暂存、写约定式提交、默认普通推送。

提交规范:主题行小写、祈使语气、无句号、72 字符内;类型含 feat、fix、docs、refactor、perf、chore、test、ci、build、style。正文可选,仅在动机或权衡不明显、多部分变更、需外部上下文时添加。WIP 检查点提交以 wip: 前缀,开 PR 前用 /rewrite-history 整理。

分支与合并:分支命名格式 type/description-TICKET-ID;特性与修复分支从默认分支切出,hotfix 从生产分支切出,PR 默认指向默认分支。无策略时建议:特性→默认分支用 squash,默认→生产用 merge commit,hotfix→生产用 squash。

PR:标题 70 字符内,含 1-3 条摘要与测试计划清单;历史重写前先备份分支、重置到基线、重新提交为清晰叙事、逐字节校验并确认后再强推。

限制:具体仓库策略优先于本规范;未提供具体平台、收费或效果信息。