SuperAPI AI 工具集

git-commit-and-push

编程与开发

查看项目

更新于 10-16 08:24

技能介绍

适用场景

当用户明确要求执行 git commit、git push,或要求把当前本地改动提交并同步到远端分支时,使用本技能。它也用于需要根据当前 diff 先生成一句简短提交内容给用户确认的情况。

不适用场景

只需编写 commit message、不需要真正提交或推送时,不使用本技能;需要创建 GitHub Issue、PR、回复评论或检查远端协作状态时,不使用本技能;需要改写 Git 历史(如 rebase、reset、commit --amend、push --force)时,不使用本技能;当前还在 master 上准备开始开发时,应先走 github-worktree。

使用方式

先查看分支和工作树状态,再决定能否提交:

git branch --show-current git status --short git diff / git diff --cached

push 前先识别远端角色,不要假设 origin 一定是 fork:

git remote -v git remote get-url --push <remote>

需区分哪个 remote 是个人 fork,哪个是上游主仓库。当前处于 master、main、release-* 等共享分支时,不要默认直接推送,应优先提醒用户改走 github-worktree 或明确确认风险。

commit 前先整理提交边界:只提交与本次需求直接相关的文件;遇到无关改动、敏感文件或可疑生成物,先停下来与用户确认。随后基于当前变更生成一条简短预览文案,默认格式为:{issue标题或规范化subject} {本次变更一句话摘要}。摘要只写这次实际新增或修改了什么,控制在一句话内。若分支能解析出 issue 号且已知 issue 标题,可复用 issue 标题作为前半句,后半句根据当前 diff 补一句说明。

特例:如果用户明确指定了某个 issue,并明确说“直接推送”,则视为对 commit + push 的一次性授权:直接使用当前 issue 标题 + issue 号作为完整 commit message;若标题已含 #issue号则原样使用,否则归一化为 <issue标题> #<issue号>;不再拼接 diff 摘要,不改写措辞、不追加其他 message,也不再展示预览或二次确认,完成必要安全检查后直接执行 git commit 和 git push。

默认路径下,先把预览内容展示给用户,等待用户明确确认(如“没问题”“可以提交”“直接 push”)后,再执行 git commit 和 git push。commit message 的格式、type 选择、Issue 号拼接规则复用 git-commit-specification。

commit 成功后再判断 push 策略,默认目标是 fork 远端:当前分支已跟踪 fork remote 时优先 git push;尚未建立 upstream 时优先 git push -u <fork-remote> HEAD;若 tracking 指向主仓库 remote,不要直接沿用,先改为 fork remote 或先向用户确认;远端领先、分叉或被拒绝时停止默认推送,先说明并确认后续同步策略。push 完成后向用户反馈实际结果:当前分支、推送到的 fork remote、是否已建立 upstream、是否还需走 PR 流程。

主要规则与限制

commit 和 push 都是有副作用的写操作,没有用户明确授权时不要自行执行。不要把用户未要求提交的无关改动塞进本次提交。预览文案要基于当前实际 diff,不要只照抄 issue 标题。只有用户明确指定 issue 且明确说“直接推送”时,才允许跳过二次确认并直接使用 issue 标题作为完整 commit message,且内容必须包含当前 #issue号。BK-CI 仓库里分支名末段若是纯数字,通常对应 GitHub Issue 号,可用于 message 对齐,但不要臆造 issue。push 默认推到个人 fork,不默认推到上游主仓库。push 只负责把本地分支同步到远端,不等于创建 PR、合并分支或关闭 Issue。应避免的陷阱包括:只看文件名不看 diff、预览文案未体现实际改动、未明确指定 issue 却误走快捷路径、命中快捷路径却漏掉 #issue号或额外追加摘要、顺手提交无关或敏感文件、未识别 fork remote 就推到主仓库、无 upstream 却用普通 git push、push 失败后直接建议强推、把“提交并推送”误当成“创建 PR 并处理评论”。

延伸阅读

commit message 与 issue 规则见 git-commit-specification;从 master 创建 issue 分支与 worktree 见 github-worktree;PR / Issue / review comment 工作流见 github-repository-management。