SuperAPI AI 工具集

git-best-practices

编程与开发

查看项目

更新于 10-15 19:55

技能介绍

用途:在创建提交、管理分支、打开 PR 或改写历史时提供 Git 操作规范;不适用于非 Git 实现任务或仓库特定发布策略决策。

主要能力与原则:先发现再操作,分支、合并或开 PR 前先运行分支发现确定默认分支与生产分支;每次提交使用 type(scope): description 格式;按文件名显式暂存,只提交预期变更;保护共享历史,强推使用 --force-with-lease 且必须事先与用户确认。

智能体工作流:检查状态(git status、git diff HEAD);发现分支;按名称暂存并核对;写约定式提交;默认普通推送,改写历史后经用户确认才用 git push --force-with-lease origin {branch}。长任务中可创建 wip: 检查点提交,开 PR 前清理。

提交纪律:显式按名暂存,核对暂存内容;避免提交密钥、.env、凭据与大型二进制文件,发现敏感文件时提醒用户;最终状态每个提交对应一个逻辑变更。

约定式提交:主题行小写、祈使语气、无句号、72 字符内;作用域可选但优先。常见类型含 feat、fix、docs、refactor、perf、chore、test、ci、build、style。正文可选,仅在变更不明显时说明原因。

分支发现:使用 gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name'、git branch --show-current 及 git branch -r --list 'origin/main' 'origin/master' 'origin/production';无 gh 或远程时参考降级命令。分支命名优先用仓库约定,否则用 type/description-TICKET-ID,如 feat/add-login-SEND-77。分支流通常从默认分支切功能与修复分支,热修从生产分支切,PR 目标为默认分支,默认与生产分支相同时直接指向该分支。

合并策略:优先仓库策略,否则特性到默认分支用压缩合并,默认到生产用合并提交,热修到生产用压缩合并。

PR 流程:使用仓库原生工具,标题 70 字符内,含 1-3 条摘要与测试计划清单;改写历史前用 /rewrite-history 备份、重置、重提交、逐字节校验,确认后再强推并附备份分支链接。

限制:资料未提供具体价格、收费、平台与效果信息。