我做了个「开源搭子」skill：零基础也能秒推 GitHub，国内自动切镜像

兄弟们，我又被"自己用得很爽"的东西感动到了，所以今天发一个 skill。
上一篇「建站搭子」是让你动动嘴就能建站；今天这个叫"开源搭子"——让零基础用户动动嘴就能把项目推到 GitHub，或者把网上的开源项目拉下来装好依赖跑起来。

先说结论：

不会 git、没配过 SSH、不知道 GitHub / Gitee / AtomGit 该选哪个——这些都没关系。
你只需要告诉我 3 句话：「我想发布」或「我想拉项目」、「项目路径」、「平台」，剩下的我帮你搞定。

📦 开源仓库地址（包含完整 SKILL.md 和 5 份 reference 文档）：

👉 https://github.com/CoderWanFeng/wanfeng-skills/tree/main/skills/opensource-housekeeper

Star 一下 ⭐、Clone 一下，跑起来就是你自己的"开源搭子"。

一、为什么做这个 skill？

我带过 100+ 程序员新手，发现一个很普遍的现象：

70% 的人不是不会写代码，而是死在"推上 GitHub"这一步。

他们会卡在：

❌ 不知道 GitHub / Gitee / AtomGit 该选哪个
❌ 不知道 SSH Key 怎么生成、怎么贴
❌ 不知道 push 失败是因为没配 key 还是没网
❌ 知道 Gitee 推公共仓库要实名，但不知道要身份证 + 人脸
❌ 看到一个 GitHub 项目很火，但国内拉不动，不会切镜像
❌ 项目 clone 下来了，但 npm install 报 peer dep 错误就放弃

这些"小障碍" 阻挡了 90% 的新手开始开源。

所以我做了 opensource-housekeeper skill，全程对话式引导，让 AI 当你的"开源陪练"。

📦 仓库：https://github.com/CoderWanFeng/wanfeng-skills/tree/main/skills/opensource-housekeeper

二、这个 skill 能帮你什么？

它有两条主线：

主线 A：发布（本地项目 → 推到开源平台）

你已经在本地写好了一个项目（代码、文档、笔记、设计稿……都行），想推上 GitHub / AtomGit / Gitee。

对话流程：

1. 我先问：你是已经有 GitHub 账号，还是想新建？
2. 再问：那个账号上"建过仓库"吗？
3. 再问：项目路径是哪里？
4. 我做网络探测，看 GitHub / Gitee / AtomGit 哪个在你这最稳
5. 我帮你生成 SSH Key（一键复制到剪贴板）
6. 我引导你把 SSH Key 贴到对应平台
7. 我帮你 git init、生成 .gitignore、写 README
8. 我引导你在平台上点几下"创建空仓库"（不要勾 README！）
9. 我帮你 git remote add + git push -u
10. 完事！🎉

主线 B：拉取（网上开源项目 → 拉到本地跑起来）

你看到一个 GitHub 项目（名字 / 地址 / 新闻都行），想本地跑一下。

对话流程：

1. 我先问：你能给我完整地址 / 项目名字 / 新闻链接？
2. 我做网络探测
3. 如果 GitHub 拉不动，我自动切国内镜像（ghfast.top / ghproxy.net / kgithub …）
4. 我搜到项目后，给你 2-3 个候选 + 一句话能力总结
5. 你选一个，我帮你 clone
6. 我自动识别项目类型（Node / Python / Go / Rust …）
7. 我帮你装依赖、启动 dev 服务
8. 服务起来了，我帮你开浏览器
9. 完事！🎉

三、5 个让我自己用了都觉得爽的细节

1. 「先问账号，再问网络，再问路径」——三步不问错

如果直接上来就让用户"配 SSH"，用户会懵。

这个 skill 永远先问账号、再问网络、再问路径，三步不问错，而且每步只问 1 个问题。

2. 失败兜底：12 类常见报错的"人话翻译"

SKILL.md 内置了 12 类常见 git 报错（比如 Permission denied (publickey)），每一类都有：

人话翻译：「GitHub 不认识你家门钥匙」
为什么：你的 SSH Key 没贴对
3 步解决：复制公钥 → 重新添加 → 测试
兜底：改用 HTTPS+PAT

不会把用户晾在报错上，这才是陪练。

3. 国内网络自动切镜像，5 个备选

GitHub 拉不动？我直接帮你切：

镜像	适合
⭐ ghfast.top	公益镜像，最稳
ghproxy.net	备选
gh-proxy.com	备选
kgithub.com	整站镜像，UI 也能用
mirror.ghproxy.com	备选

而且有自动转换脚本，把 GitHub 地址 sed 一下就成镜像地址，不用你复制粘贴。

4. Gitee 实名主动提示

Gitee 2022 年起推公共仓库要身份证 + 人脸，这个 skill 在用户选 Gitee 时主动告知（不是失败后再说），并且推荐「不想实名就换 AtomGit」。

5. 自动识别项目类型 + 装依赖

看到	就装
`package.json`	`npm install`
`pyproject.toml`	`poetry install`
`go.mod`	`go mod download`
`Cargo.toml`	`cargo build`
都没看到	读 README 兜底

不用你自己去查"这个项目怎么装"。

四、怎么用这个 skill？

最快的方式：

# 1. 克隆仓库
git clone https://github.com/CoderWanFeng/wanfeng-skills.git

# 2. 切换到 skill 目录
cd wanfeng-skills/skills/opensource-housekeeper

# 3. 打开 SKILL.md 看你想跑的流程
# - 主线 A（发布）：从 SKILL.md 第 32 行开始
# - 主线 B（拉取）：从 SKILL.md 第 506 行开始

或者直接看仓库的 SKILL.md：

👉 https://github.com/CoderWanFeng/wanfeng-skills/tree/main/skills/opensource-housekeeper

实战对话示例

发布场景：

✅ 用户：「我想把我的 python 工具推到 GitHub」
✅ AI：「好。你有 GitHub 账号吗？」
✅ 用户：「有，已经建了仓库」
✅ AI：「把 SSH 地址发我，我帮你推」

拉取场景：

✅ 用户：「我想跑一下 llama.cpp」
✅ AI：「好。我先探测一下网络，看 GitHub 能不能直连」
   （3 秒后）
✅ AI：「GitHub 在你这 5KB/s，太慢。我切到 ghfast.top 镜像，你 OK 吗？」
✅ 用户：「OK」
✅ AI：「拉好了，检测到是 C++ 项目，需要先装 cmake、gcc。装吗？」
✅ 用户：「装」
✅ AI：「好，编译要 5 分钟，先去喝杯水……」

五、这个 skill 适合谁？

适合	不太适合
第一次用 GitHub / Gitee 的小白	已经熟 git 的大佬（用 GitHub Desktop 更直接）
写了项目想发布但怕踩坑的人	团队 push（这个 skill 主打个人项目）
国内开发者（被网络卡过的人）	海外开发者（直接 GitHub 就行）
想 pull 一个开源项目但不会装依赖的人	想要 CI/CD 自动化（这 skill 不管这一段）

六、和我的「建站搭子」怎么配合？

我做的两个 skill 正好是前后衔接：

【建站搭子】→ 帮你从 0 搭一个个人网站
                ↓
       你的网站有了，代码在本地
                ↓
【开源搭子】→ 帮你把网站推到 GitHub / Gitee
                ↓
       你的网站有了，还有了开源版本
                ↓
       AI 可以推荐你，更多人认识你

这就是我之前那篇《日入 1000，我把个人网站开源了》的完整工具链。

📦 整套 skill 都在这里：https://github.com/CoderWanFeng/wanfeng-skills/tree/main/skills/opensource-housekeeper