SuperAPI AI 工具集

git-workflow

办公与效率

查看项目

更新于 10-15 21:47

技能介绍

用途:该技能用于按用户既定的 Git 默认规则执行分支、更新、提交、推送与合并操作,确保每次改动停留在新的聚焦分支上,历史可审阅、可恢复,且不丢失本地工作。用户对某项默认规则的明确指示,仅替代该工作流中的对应默认;跨轮次保持,直至被更改;新仓库或新操作需重新确定范围。

主要能力:从远端默认分支解析基线,不硬编码 main;新工作前自动做远端默认分支同步预检。若从本地默认分支开始且工作区干净,自动 fetch 并快进到远端默认分支最新提交;遇到本地独有提交、分叉或非快进更新则停止。工作区脏时先停止,让用户选择丢弃或保留并从最新远端默认分支新建分支/worktree。新建的聚焦分支与 worktree 建立在刚 fetch 的远端默认提交上,不追踪远端默认分支,仅在推送该分支时设置上游。

提交与推送:用 merge 远端基线更新分支,禁止 rebase;禁止 amend,每个修正新增提交;禁止 force-push,普通推送因历史分叉被拒则停止。只暂存相关文件,排除密钥与无关本地改动。提交标题用简洁的祈使语气 Conventional Commit,并陈述可观察影响。除非用户明确要求,否则让 hooks 运行。

发布检查:每次提交、推送与 GitHub 写操作前运行 scripts/publication_guard.py(Python 3.11+,需 gh 已登录)。提交前把信息写入文件,运行 staged --message-file FILE,再用 git commit -F FILE。推送前运行 outgoing --base BASE。PR 标题与正文写入文件后运行 pr --repo OWNER/REPO --title-file FILE --body-file FILE。按其退出码处理:0 继续;出现 rewrote 行则报告重写与占位行;出现未检查路径或配置警告需自行核查并报告;退出 2 修复原因后重跑;其他退出码停止发布并报告。

默认分支健康与合并:新工作前与每次合并前检查默认分支最新提交的必需 CI。绿色才可开始或合并;pending 需等待;无结果不算绿色;红色须先修复,无人负责且当前请求授权合并时通过 /deliver 单独交付修复。合并采用 squash-merge 并删除源分支,PR 标题即基础分支提交标题,需符合 Conventional Commit 并体现整体可观察影响。合并后同步本地基础分支并删除已合并本地分支。

原生 GitHub stacks:仅在用户选择、存在真实依赖链或确认的大型问题被有意拆分时使用。每层需单一主张、有界 diff、独立验证与明确的需求子集。创建、同步、推送、提交、审阅或合并前须阅读 references/github-stacks.md;仅经核实的 gh stack 命令可在干净确认的原生 stack 上执行 rebase 与 force-with-lease,原始 git rebase、git push --force 及手动的 git push --force-with-lease 仍被禁止。

限制:具体项目配置、CI 提供方细节及国内可用性资料暂未提供。