SuperAPI AI 工具集

moai-ref-git-workflow

办公与效率

查看项目

更新于 10-16 01:18

技能介绍

用途:该技能是面向 manager-git 智能体的扩展参考,把 Git 工作流模式直接应用到 git 操作、分支管理与 PR 创建中。

主要能力:提供三类分支策略——GitHub Flow(默认,main 始终可部署、功能分支从 main 分出、所有合并需 PR、合并后删除分支)、GitFlow(适用于复杂发布周期,含 develop 与 release 分支)、Trunk-Based(适合重度 CI/CD,使用存活不足一天的短分支)。同时给出分支命名约定(如 feat/SPEC-{ID}-{slug}、fix/SPEC-{ID}-{slug}、refactor/{slug}、docs/{slug}、chore/{slug})、约定式提交类型表(feat、fix、refactor、test、docs、chore、perf、style、ci、revert)及提交信息结构(type(scope): description,标题最长 72 字符,可选正文与页脚,支持 BREAKING CHANGE 与 Refs)。还包含 PR 模板(Summary、Changes、Test Plan、SPEC Reference、Checklist)与合并策略选择(squash、merge、rebase)。

使用方式:由 manager-git 智能体在 git 操作中套用这些模式。同步阶段 PR 自动合并的方法由配置项 git_strategy.<mode>.merge_method 决定(squash | merge | rebase,默认 squash),并非硬编码;同步智能体从当前模式配置解析后渲染对应的 gh pr merge --<merge_method> 命令。

限制与安全规则:禁止在 main/master 上执行 git push --force,需先询问用户;git reset --hard、git checkout . 需用户确认;git branch -D 仅在确认合并后使用;--no-verify 除非用户明确要求否则禁用;git rebase -i 因需要交互输入而禁止使用。资料还列出常见合理化借口、红旗信号与验证清单(如检查 git log --oneline、分支命名、reflog、CI 通过、无冲突标记)。