用途
Git for Everyone 是一个教学型技能,服务对象是对版本控制完全陌生的人,包括今天之前从未使用过终端的人。它的定位是让 Git 和 GitHub 变得平易近人、安全,甚至带一点趣味。
主要能力
该技能明确列出四项职责:
- 翻译器:把用户用大白话表达的目标,转换成正确的命令。
- 导师:用日常类比解释概念,绝不先抛术语。
- 安全网:在执行任何具破坏性的操作前停下来,并说明可能损失什么。
- GitHub 向导:协助完成 clone、向新仓库 push、PR、Fork、Issue,以及 gh auth login。
使用方式
技能遵循几条核心规则:
- 先讲述再执行。在执行任何 git 或 gh 命令之前,先用一句日常语言说明它将做什么,然后才运行。文档强调这一步即便对 git status 这类无害命令也不可选,因为用户是在学习,默默执行的命令教不了任何东西。
- 先类比后术语。解释时不从技术名词开始,而是先说它像什么,再给出名称。例如把 commit 比作游戏里的"保存进度"。常见术语的通俗解释收录在 references/glossary.md。
- 破坏性命令前必须停下。会先说明后果、建议更安全的做法并请求明确确认,涉及的命令包括 git reset --hard、git push --force / -f / --force-with-lease、git branch -D、会丢弃未提交修改的 git checkout . / git restore、git clean -fd / -fx、对已推送提交的 rebase、rm -rf .git,以及向共享仓库的 main / master 推送。默认始终选择更温和的工具:优先 git revert 而非 git reset --hard,优先 git stash 而非丢弃编辑,优先新建分支而非改写 main,只有在强推不可避免且已确认时才用 --force-with-lease 而非 --force。完整清单在 references/safety-net.md。
- 把吓人的报错翻译成善意的话。不照搬错误信息,而是翻译成大白话、说明含义并给出下一步,相关内容在 references/error-translations.md。
- 庆祝小成就。首次提交、首次推送、首次 PR、第一次独立解决合并冲突都值得一句真诚的肯定。
- 绝不让用户觉得自己笨。问"什么是分支"是被鼓励的行为;弄坏东西的回应永远是"没关系,我们来看看发生了什么、怎么修",而绝不是"你本该知道"。
适用场景
当用户描述诸如"保存我的工作""把这个分享给同事""获取最新改动""撤销上一次修改""我想试试但不想弄坏任何东西""在 GitHub 上开始一个新项目""拿到别人项目的副本""我想给不属于我的项目提个修改建议"等意图时,技能会读取 references/recipes.md 中对应的配方,先用自己的话复述确认用户意图,再逐条讲述并执行命令,最后确认成功并提示下一步。
涉及 github.com 的操作——克隆仓库、从现有文件夹创建新仓库、发起 PR、Fork、提 Issue、登录——都有专门的流程说明在 references/github-flows.md。首次需要认证的 GitHub 操作,会温和地引导完成 gh auth login。
逐步建立的心智模型
技能不会一次性灌输概念,而是在概念真正有用时逐个引入:仓库是一个记得自己历史的文件夹;commit 是保存的快照;分支是平行时间线;GitHub 是托管仓库的网站,而 Git 本身脱离 GitHub 也能正常工作;push 是把快照上传到 GitHub,pull 是下载别人的快照;pull request 就是"我改了东西,你能看看并合并吗"。
限制与说明
资料未提供该技能的具体安装命令、平台支持范围、收费方式或价格等信息,这些事实暂未提供。资料也未说明其内置参考文件之外的功能。