SuperAPI AI 工具集

commit-push-sync

编程与开发

查看项目

更新于 10-16 05:49

技能介绍

用途:在用户明确要求提交、拆分提交、暂存并提交、推送、同步分支或直接提交到默认分支时使用,生成逻辑范围清晰的提交并推送指定分支,同时不吸收无关的用户改动。

主要能力:先检查仓库状态(git rev-parse --show-toplevel、git status -sb、git branch --show-current、git remote -v、git diff --stat、git diff、git diff --cached),读取 CONTRIBUTING.md 等仓库说明并参考近期提交风格;按请求与差异锁定范围,保留无关的已跟踪、未跟踪、已暂存和未暂存改动;提交前运行聚焦的相关检查;将改动拆分为可独立回滚的单元,实现与其测试放在一起,前置提交排在依赖项之前;提交后检查实际落地内容(git diff --cached --stat、git diff --cached、git commit -m "<message>"、git show --stat --oneline HEAD);推送前获取并协调所选上游远端(git fetch <remote>、git status -sb),必要时将本地提交变基到上游;推送当前分支(git push -u <remote> HEAD),对已推送且明确属于用户的主题分支变基后使用 git push --force-with-lease,绝不使用普通 --force;最后验证结果(git status -sb、git log --oneline -n 5)。

提交规范:一个提交代表一个可独立评审和回滚的逻辑变更;优先使用仓库的消息约定,无约定时使用 <type>(<scope>): <imperative subject> 及说明原因与影响的正文,类型包括 feat、fix、refactor、docs、test、chore、ci、perf、style;默认使用简洁英文,除非仓库和用户确立其他语言;不添加代理品牌、Co-Authored-By 或作者行,除非明确要求。

副作用边界:提交/推送请求的默认授权仅覆盖范围内的 Git 提交及其分支推送,不覆盖 issue 评论、issue/PR 正文或标题编辑、发布、标签或其他远端变更,除非同一请求明确包含。

输出契约:先说明提交和推送是否成功,包含每个新提交的哈希与主题、推送的远端与分支(是否使用跟踪或 --force-with-lease)、运行的检查及结果、未运行且影响信心的内容、剩余的暂存/未暂存/未跟踪改动,以及推送未完成时的确切阻塞点和最小下一步。

限制与注意事项:不要在混合工作区盲目运行 git pull --rebase;pre-commit 钩子失败意味着提交未成功,只修复范围内失败并重试,除非用户明确接受风险否则不绕过钩子;不要仅为美化历史而修改、压缩、变基或强制推送共享分支;不要仅凭本地提交输出声称推送成功;若仓库使用 jj 或其他 VCS 层,在 Git 变更前停止并使用仓库特定的发布路径。