技能介绍

解决什么问题

Git 操作里常踩的坑不是不会写命令，而是缺少仓库上下文：不知道当前分支、未提交改动、远程 ahead/behind，也分不清哪些操作不可逆。用户说“备份一下”“拉下来”“撤销刚才提交”，如果直接变成 git push、git pull 或 git reset --hard，可能误推、漏推或丢改动。Git Plain Speak 把自然语言意图映射到有限、可确认的 Git 工作流。

技能如何工作

技能默认作用于当前工作目录仓库，先运行 scripts/git_status_summary.py 获取结构化状态：是否仓库、当前分支、改动文件、ahead/behind、最近提交和远程地址。随后按意图路由：

GitHub 配置：检测 gh CLI 与登录状态，引导设备码授权，创建或关联仓库后再推送。
备份：读取 git diff --stat，生成中文 commit 消息，按用户范围执行 git add、git commit、git push。
查询：用 git status、git log、git blame、git show 解释改动与历史。
回滚：区分未提交、未 push、已 push，优先 git restore、git reset、git revert，强制操作必须确认。
分支：创建、切换、合并、删除分支；冲突时列出冲突点，不擅自改业务逻辑。

适用边界

它适合单人项目、GitHub 公开或私有仓库、日常提交与分支协作，强调“先检测、后执行”。没有 remote 时引导配置而不是擅自推送；遇到 non-fast-forward、合并冲突和危险操作时，会说明影响范围并要求明确确认。它不替代代码审查、CI 安全策略、团队 Git 规范，也不承诺自动解决复杂网络、权限或沙箱登录问题。