文章

我的第一个 GitHub 开源 PR 合入了

今天真的很开心。

昨天晚上,我提交了一个 PR —— 这是我从业近 9 年以来,第一次在 GitHub 开源社区提出自己的第一个 PR。

地址是 erha19/ping-island#312,9 月 12 号合入的。从提交到 merge,作者过了 11 个小时就做完了 review。说实话,挺感慨的。

什么是 ping-island?

这是一个 AI 任务提示音小工具,我自己用得很多。它的核心功能是:当你用 AI 跑各种任务(比如 coding agent、批量处理、数据生成)的时候,任务开始、结束、失败,都会有不同的提示音提醒你。

以前总是盯着屏幕等结果,有了这个之后,耳朵代替眼睛来感知进度,不用一直盯着了。

问题的发现与修复

我发现那个声音开关有点问题——项目里有四个独立的开关,分别控制不同事件的提示音。但我希望任务开始的时候不需要提醒我,只想让结束和失败的提示生效,这样就能关掉其中一个开关。结果发现那个开关压根不好使。

好,那就自己研究代码,自己修。

我把仓库 clone 下来,让 AI 帮我看了逻辑,然后用 Claude Code 里自带的工具修了几个文件。修完之后本地跑了一下,测了各场景,确认没问题,就决定提 PR。

规范地提 PR

但社区的开源项目都有比较严格的 PR 规范。于是我又装了 GitHub 官方的 gh 命令行工具,让 AI 帮我写了符合规范的 commit message 和 PR 描述——说明怎么发现这个问题的、怎么修的、怎么跑单测的。一步步走完整个流程。

最终作者的 review 也认可了这个修复,直接合入了。

ping-island PR #312 已合入

AI 时代的开源贡献

说实话,这次体验让我意识到:有了 AI 之后,参与开源真的方便太多了。

这次用的工具就是 Claude Code,里面的 AGNESS 模型目前还是免费的,帮我做代码分析、写 commit message、解释 PR 规范,全程都很顺畅。而且不是用什么很高级的东西——就是一个正常的 AI 编码助手,但足以帮我把一个 bug 修完并提上去。

以前觉得开源贡献门槛很高,要熟悉代码库、要懂贡献规范、要小心别踩坑。这次实际做下来才发现:只要你会用 AI 工具,普通开发者完全有能力为开源项目做出贡献。

写在最后

快九年了,终于在自己的名字前面,加上了第一个开源贡献。

不复杂的一个修复,但意义不一样。

如果你也在用 AI 工具,试试去找一个你觉得好用的开源小工具,看看有没有你关心的 issue 或者 bug。说不定,你的第一个 PR 就在不远处等着。

阅读 — · 全站 —
本文由作者按照 CC BY 4.0 进行授权
🎸 我的歌单 0 首