rosetta-github-cookbook

写给零基础的 GitHub 完整入门 --- 由 Rosetta 制作，承接 PM-101

第 1 章完整收录 PM-101 的 GitHub 部分（是什么 / 环境配置 / 克隆 / 上传）， 在此之上，用同样的篇幅和难度，展开分支、同步、冲突、协作。

为什么值得学

• 为了用好 ==WorkBuddy、TRAE== 这类 AI 工具——「会不会写」不再是门槛，「会不会管」才是
• 为了我们的开发和经验==沉淀成资产==：每一步有记录，人走了，资产留在团队
• 为了==不动代码的人==，也能安全地上线可迭代的代码 / agent
• 最重要的是四个意识：==安全 · 流程 · 规范 · 协作==——操作 AI 全权代劳，你把关

📜知识大纲

1 入门：Git 和 GitHub

• Git 和 GitHub 是什么：Git 保存时光机，GitHub 把时光机放到网上
• Git 环境配置：安装 + 告诉 Git 你是谁
• 获取代码：完整下载别人的 GitHub 仓库：代码 + 全部历史一起到你的电脑（行话叫克隆）
• Git 第一次上传：身份 + Token 钥匙 + 三部曲
• 上传 GitHub 和上传微盘，差在哪：为什么不能拖拽了事

2 分支

• 为什么要有分支：不碰运行中的代码 / 先审计再合并 / 多人隔离
• 分支怎么用：建、切、删
• 为什么微盘没有分支，GitHub 有：高风险、高安全、高度严谨

3 迭代之后：如何交卷

• push：把这次修改传上去存好：像传网盘，但传的是存档
• pull：把别人的修改拉到我电脑：开工先收信
• merge：把两张试卷誊到一张大纸上：审过才誊，两边都保留
• 一天的节奏：开工 pull → 分支干活 → 收工 push → 审计后 merge 汇合

4 冲突

• 冲突了怎么办：Git 停下来问你听谁的

5 协作

• PR 是什么：正式的合并申请，先审后合
• 正确的更新方式：分支送审 → 打回重修循环 → 合并 main + 更新 README
• Fork 是什么：把别人的仓库拿一份自己改

配套：作业 · 学习目标 · 写给AI的注意事项

🔧 配套 skill：git-github

本教材自带一个可直接分发的 AI skill：skills/git-github/SKILL.md。

它把教材变成「必须照做」的流程，==用户可以完全不懂 git==：

• 核心循环：独立分支推送远程（==不许合并 main==）→ agent 按==生产产品级别==标准审核是否 LGTM → 不达标打回重修、循环送审 → 验收通过才合并 main + 更新 README
• 第一次使用：检查环境 → 引导安装 Git 和 gh CLI → 登录钥匙（PAT / 浏览器登录，全程不落盘）
• 已有环境（说明用户已经试过）：不重新配置，只做体检，确保流程正确
• 全新文件夹第一次上传：专门路径（init → 建云端仓库 → 连上 → 首存档）
• 硬性六道门：开工收信 → 独立分支 → 存档寄出（含==秘密扫描==）→ ==发出去的东西安全吗（dist 审核）== → ==代码审计== → ==放行审核==
• 内置两个子 skill：dist-review（可分发性审查，含 scan.py 扫描器）、readme-writing（产品级文档规范）
• 只想「存一下」就到门 3 收工；隔天回来说「继续」能接上进度
• 附教材速查表，用户问「为什么」就翻对应章节

用法：把 skills/git-github 整个目录复制进你的 Agent 的技能目录（如 ~/.agents/skills/），或让 Agent 直接读 SKILL.md。