用途:作为本地 Git 协作与恢复的锚点,不试图讲完整个 Git,而是快速识别当前本地 Git 状态、选定一种安全工作流模式,并推荐解决当前问题的最小可回退操作。同时明确与代码评审、调试、任务规划、托管 PR 流程的边界。
主要能力(六种模式,每次只选一种):分支与暂存整理(建/切分支、选择性暂存、stash 或清理的取舍);提交整形(amend、fixup、reword、交互式 rebase,形成可评审的提交单元);与基线同步(fetch 后明确选择 merge 还是 rebase);冲突解决(检查→解决→git add→继续或提交,abort 作为冷静回退);推送安全(上游设置、被拒推送、分支分叉、重写历史后的安全推送);撤销与恢复(reset/rebase/amend/checkout/删分支出错后的抢救)。
核心安全规则:不可逆操作前先跑 git status、git branch --show-current、git log --oneline --decorate -5。提交边界重要时优先 git add -p 或显式暂存;仅在本地或可安全重写的历史上 amend 或交互式 rebase;分支基本属于自己且线性历史有助于评审时用 rebase,分支共享或需保留集成上下文时用 merge;有意重写历史后优先 git push --force-with-lease,绝不用裸 --force;坏提交已共享时优先 git revert 而非 reset --hard;慌乱清理前先用 git reflog 并从旧 SHA 建救援分支。
使用方式:先分类请求(当前目标、分支状态、协作风险、远端上下文、触发事件、偏好历史、置信度),信息不全时选最安全的下一步并说明假设;随后输出精简的 Git Workflow Brief,包含推荐模式及理由、当前状态、最安全的下一步、命令、为何安全、注意事项与恢复回退,并注明相邻技能的交接。
适用场景:编码或评审前整理分支、整理本地提交、决定 merge/rebase、安全解决冲突、推送或更新已重写历史、从错误 reset、错分支提交、detached HEAD、丢失提交或混乱 rebase 中恢复、在后续 PR 或评审前准备干净 diff。示例:rebase 后需安全推送用 push-safety,推荐 git push --force-with-lease origin <branch> 并警告勿用裸 --force;整理提交用 commit-shaping 配合显式暂存与 git rebase -i 或 git commit --amend;误 reset 用 undo-and-recovery,先 git reflog 再建救援分支。
限制:不适用于判断代码或架构好坏、任务拆分与排序、根因分析,以及托管服务侧 PR 生命周期、分支保护、评审人、标签或仓库设置等场景,这些应路由到 code-review、debugging、task-planning 或专门的 PR/仓库管理流程,如 Aider 편집 루프则走 aider-cli-workflow。不应把本技能当作完整 Git 教程,也不要臆断每个分支都该 rebase,且不得随意推荐 reset --hard 而不说明数据丢失风险。参考资料含 references/collaboration-boundaries.md、references/mode-selection-and-command-packets.md、references/recovery-patterns.md,以及 Git、GitHub、GitLab 官方文档链接。