用途:为 Git 提交信息与版本控制流程提供统一约定,覆盖提交格式、分支策略与工作流模式。
主要能力:采用 Conventional Commits 格式 <type>(<scope>): <subject>,类型包括 feat、fix、docs、style、refactor、perf、test、chore、ci、build、revert;要求祈使语气、现在时、小写、不加句号、标题不超过 50 字符。提供分支命名模式,如 feat/user-auth、fix/login-bug、hotfix/security-patch、chore/update-deps。给出 rebase 与 merge 的适用场景:rebase 用于保持特性分支最新与线性历史,merge 用于经 PR 合入主干并保留历史。
使用方式:提交前先执行 git status && git diff HEAD && git branch --show-current && git log --oneline -5 检查状态,确认不在 main/master 上;只暂存指定文件,禁止 git add -A;再以约定格式提交,例如 git commit -m "feat(auth): add JWT validation"。常用命令包括 git checkout -b feat/user-auth、git fetch origin && git rebase origin/main、git stash && git stash pop。提交前需运行 make check && make test-e2e。
PR 后续循环:PR 打开后可用基于时间的循环处理 CI 失败与评审意见,例如 /loop 10m check PR #<N>,修复后提交并推送,直到 CI 通过且意见处理完毕;循环内禁止强制推送,仅允许 --force-with-lease,且仅用于按要求对 main 变基产生的冲突。
限制与规则:绝不自动推送,唯一例外是作用域限于该 PR 分支的 PR 循环;未经明确授权不得在 main/master 上工作;提交应小而聚焦;共享分支禁用裸 --force;不得绕过钩子。冲突解决与恢复命令(reset、reflog、revert、amend)使用标准 git,无项目特定约定。