GitHub 小白实战:发布第一个作品
开源永远万岁
何为GitHub ?为什么都说它YYDS?
以前GitHub只在程序员间广泛流传并应用,现在随着AI浪潮的到来,GitHub也跃然纸上,从技术圈跑到了大众视野里。…
我发现评论区里还有很多人说:道理看懂了,可真打开 GitHub,还是不知道第一步该干什么。很多人也是到了这波 AI 浪潮,才第一次接触它。
今天我就手把手教你如何在 GitHub上建立你自己的第一个仓库。
做完以后,你手上会有:
- 一个可以直接分享的 github-toolbox 仓库;
- 一份别人打开就知道怎么用的说明页;
- 一条可以复制使用、以后还能继续修改的 AI 提示词;
- 一个让别人反馈问题的入口。
全程在网页里完成,不用写代码,也不用碰命令行。
现在我们开整。
一、先建仓库,拿到第一条公开地址
登录 GitHub,网页右上角点击头像,出现下拉菜单 新建 Repository 的入口。Repository 中文常叫“仓库”,你先把它理解成一份带网址、修改记录和反馈区的项目文件夹。
找到绿色按钮 New。
第一次这样填:
- Repository name:github-toolbox
- Description:我整理和更新自己常用的 AI 提示词与工作模板
- 可见性:想让别人打开就能看,选 Public;暂时只给自己看,选 Private
- README:默认是OFF,点击On,让 GitHub 同时创建一个说明页
点下创建以后,仓库里会出现一个 README.md。README 会直接显示在仓库首页,别人点开你的链接,先看到的就是它。
点击 README 右边的小铅笔,把原来的内容换成下面这段:
1 | # 我的 GitHub 工具箱 |
右上角点 Commit changes 保存。
GitHub 会让你写一句“这次改了什么”。填:
1 | 建立工具箱首页 |
这里的 Commit 可以先理解成一次带说明的保存。以后每改一次,GitHub 都会留下时间、修改人和修改内容。哪天改坏了,也能回头查以前写过什么。
到这里,你已经有仓库和公开地址了。
不过现在里面只有一张说明页,还没有真正要分享的文件。
二、在仓库里新建文件,把第一份内容发出来
这一章只学一个动作:在仓库里新建文件。
我们拿“AI 文章审稿提示词”做个例子,复制进去就能发布,不要求你会写代码。以后你想放清单、教程或工作模板,操作都一样。
回到仓库首页,绿色按钮旁边,点击 Add file,再选 Create new file。
文件名填:
1 | prompts/article-review.md |
斜杠前面的 prompts 会成为一个文件夹。后面的 .md 代表 Markdown 文档,你可以把它理解成 GitHub 很常用的一种纯文本文件。
正文复制下面这份:
1 | # AI 文章审稿提示词 |
页面右边绿色按钮再次点 Commit changes,这次写:
1 | 加入文章审稿提示词 |
提交成功以后,仓库里会多出 prompts 文件夹。点进去,就能看到刚才那份提示词。
现在再回到 README 进行编辑,把“第一条内容正在上传”换成:
1 | ## 已发布 |
保存说明写:
1 | 在首页加入提示词入口 |
重新打开仓库首页,点一下“AI 文章审稿提示词”。能正常进入文件,就说明你已经学会了两件事:在仓库里创建内容,再从 README 给它留一个入口。
这里以后还可以换成检查清单、教程或模板,还是这套操作。
三、亲手改一次,才会明白 Commit 有什么用
GitHub 和普通网盘最不一样的地方,是它不只保存“现在这份文件”,还会把你每次修改留下来。
打开 prompts/article-review.md,点击小铅笔,在提示词最后补一段:
1 | ## 更新记录 |
保存时填写:
1 | 补充事实核查要求 |
先回到仓库首页,依次点开 prompts 文件夹和 article-review.md。
进入 article-review.md 后,看文件名右边就有 History
点击 History,页面会列出所有修改过这份文件的提交记录。
再点刚才填写的 补充事实核查要求,就能看到那一次增加或删除了哪些行。
以后有人问“这一条什么时候加的”“上一版怎么写”,不用翻聊天记录,也不用在电脑里找“最终版2”“最终版真的最终”。 记录就在这里。
到这里,你已经会新建文件、修改内容,也知道去哪里查看以前的版本。自己的第一个小仓库先这样用就够了,等以后需要多人一起修改时,再学分支
如果电脑里已经有写好的提示词、清单或说明文档,就不用再一份份复制了,直接上传更快。
四、你已经有现成文件,也可以直接拖进来
提示词、清单、教程、表格样例、说明文档,只要适合公开,都能放进仓库。
回到仓库首页,点击 Add file,选择 Upload files,把电脑里的文件拖到页面中,再填写这次上传的说明并提交。
文件多起来以后,再按用途分文件夹:
github-toolbox/ ├── README.md ├── prompts/ AI 提示词 ├── templates/ 可以复制的表格和文档模板 └── examples/ 使用前后的示例
刚开始只有一两个文件,不用急着把目录搭得很大。先放进去,再根据真实内容整理。
用网页上传时,GitHub 当前说明是单个文件不超过 25 MiB,一次最多上传 100 个文件。大视频、原始素材包和软件缓存,不适合直接往里塞。
还有一条比文件大小更重要:不要把不该公开的东西一起拖进去。
五、分享以前,先看公开范围和敏感信息
建仓库时选了 Public,任何拿到链接的人都能看到;选了 Private,只有获得权限的人能访问。还没整理好、里面有私人材料,先用 Private 更稳妥。
公开前检查一遍:
- 有没有 API Key、Token、Cookie、密码或钱包私钥;
- 有没有客户文件、内部资料、私人照片、手机号和邮箱;
- 截图里有没有浏览器账号、文件路径或通知内容;
- AI 对话记录里有没有顺手粘进去的隐私。
我这里放了可以让你智能体帮你检查的提示词。
复制这段提示词,做一次公开前检查
1 | 我要把一个 GitHub 仓库分享给别人。请对我提供的内容做一次公开前安全检查。 |
AI 只能帮你发现比较明显的问题,不能替你保证“绝对没有泄露”。尤其是旧版本、图片角落和它没有读到的文件,仍要自己确认。
敏感信息一旦提交过,只删除当前文件还不一定够,因为旧版本和别人保存的副本里可能仍然存在。先去对应平台把那把 Key、Token 或密码作废并换新,再处理仓库里的记录。
还有一点容易混。仓库设成 Public 后,别人可以打开页面,也可以在 GitHub 里 Fork 一份。但他能不能把你的提示词复制到自己的作品里、改写后再发布,要看仓库里的许可证。
许可证通常是一份名为 LICENSE 的文件,里面写着别人可以怎样使用你的内容。没有这份文件,默认的版权规则仍然有效,别人不会因为仓库公开就自动获得复制、修改和再次发布的许可。这次只想把链接发给别人看,可以先不加;以后确实想让别人自由使用,再单独了解和选择。
仓库分享出去以后,别人用你的提示词发现结果不对,通常会回来问你。怎样可以高效的找到问题的根源?
六、别人提交的问题说不清,你就不知道从哪里改
在 GitHub 里,别人用你的内容时遇到问题,可以进入仓库的 Issues,点击 New issue 提交一张问题单。你可以在下面继续回复,问题解决后再把它关闭。
可很多人只留下一句“不能用”就没了。你连他用的是哪个文件、在哪个 AI 里跑的都不知道,更别说中间做过什么、原本想得到什么。
所以只能一项项往回问。来回几次,还是搞不清到底是提示词有问题、说明没写明白,还是他用的软件不同。
解决办法很直接:提前放一份固定格式的问题模板,让对方照着填写。GitHub 的 Issue template 就是做这个的。
点击 Add file,选择 Create new file,文件名填写:
1 | .github/ISSUE_TEMPLATE/problem-report.md |
正文复制:
1 | --- |
保存说明写:
1 | 加入问题反模板 |
提交完成后,别人进入仓库的 Issues,点击 New issue,就能看到这份模板。你以后去别人的项目提问,也可以照着这个顺序写:用了什么、做了哪些步骤、希望看到什么、实际发生了什么。
你已经把一条原本只躺在聊天记录里的提示词,整理成了一个别人能打开、能使用,遇到问题也知道怎么告诉你的 GitHub 仓库。
最后,把链接发给第一个使用者
现在就把仓库链接发给一个愿意帮你试用的人。让他照着 README 用一次,哪里看不懂、哪里结果不对,就按仓库里的问题单告诉你。
第一次用 GitHub,做到这里就够了。
恭喜啊,你的第一份作品,就这样完美的发出去了。





