技能介绍

要解决什么问题

日常发版常卡在几件事：先跑 lint，再 git commit，推当前分支，切到 develop / preview / master 拉最新，合并，再推目标分支并切回。中间还有未暂存文件、凭据首次失败挂起、merge 冲突等。本技能把这条链路写成固定顺序的 10 步流程，并强调只提交已暂存内容，避免误用 git commit -a 把未 review 的改动一并提交。

技能如何工作

参数解析优先识别 --no-verify（跳过 lint 与 hooks）、--dry-run（只输出将要执行的 git 命令），以及 --develop / --preview / --master 或自定义 --feature/xxx 目标分支；未指定时默认合并到 develop。

执行前会做仓库、Git 版本（≥2.23 用 git switch）、是否在 merge/rebase、Detached HEAD、浅克隆、GPG、凭据与并发锁等检查。工作区干净时自动走仅合并（MERGE_ONLY）；有未暂存/未跟踪文件时默认不自动 git add，需你明确选择暂存策略。

核心步骤包括：可选 npm run lint（可 --fix）、预览 git diff --cached 并确认 Conventional Commits 风格的 message、推送源分支、切换目标分支并 pull、执行 git merge，冲突时可选手动、AI 辅助或中止（中止会说明如何切回源分支与 stash）。网络操作会设置 GIT_TERMINAL_PROMPT=0、SSH BatchMode 与超时重试，减少 Windows 下凭据未就绪导致的 Permission denied 与进程挂起。

适用边界与注意点

快捷分支（develop/preview/master）在文档里绑定了对应 CI 语义；自定义分支不触发预定义 CI，以你仓库配置为准。
--no-verify 会同时跳过技能内 lint 与提交钩子；若 pre-commit 里也有 lint，可能与第 3 步重复，文档建议把 lint 统一交给技能或钩子之一。
目标分支受保护、必须走 PR 时，push 失败会提示改走 PR，不会强行绕过策略。
SKILL.md 为流程的单一事实来源；Dry-Run 在提交与合并前会停下，不写库。

截图预览

使用场景

功能分支上已手动暂存部分文件，需要先跑 lint，再只提交暂存区并合并到 develop 以触发 devbuild。
预发验证前要把当前分支推到 origin，切换到 preview 拉最新并完成 merge，配合项目的 prebuild 流程。
工作区仍有未暂存或未跟踪改动，只想提交此前已 `git add` 的文件，避免整仓被自动加入 commit。
不确定 push、切分支、merge 的顺序与命令时，用 `--dry-run` 先拿到完整 git 命令清单再决定是否执行。

适合人员

维护 develop / preview / master 分支并依赖不同 npm build 脚本的前端工程师
在 Windows 上常遇首次 push 凭据失败或 git 进程挂起，需要预热凭据与超时重试的仓库协作者
负责 feature 分支收尾、希望在 merge 前预览 `git diff --cached` 并确认 Conventional Commits 信息的技术负责人
需要在 merge 冲突时选择手动修复、AI 辅助或中止并切回源分支恢复 stash 的合并执行者