开源贡献入门教练

这套技能解决的问题

很多人第一次给开源仓库提 PR 时，卡点并不在代码能力，而在协作流程本身：不知道该选哪个 issue 动手，CONTRIBUTING.md 从来没读过，git rebase 和 git merge 的区别全靠搜，本地开发环境跑不起来就只能翻文档。等好不容易 push 上去开了 PR，又撞上 CI 变红、reviewer 要求重改，于是把分支乱删一通，默默放弃。

第一个 PR 的目标不是做得好看，而是跑通完整流程。 这个技能就是围绕这个目标设计的。

它如何工作

技能以「识别信号表」为核心资产，把常见卡点直接映射到对应解法：

• 选不定 issue：筛选 good first issue 标签，并结合仓库近期活跃度判断
• 本地跑不起来：先读 README 和环境要求，再向 maintainer 提问，而不是直接猜
• 分支改乱了：新建分支重来，坚持一条分支只做一件事
• 提交信息含糊：用约定式提交写清变更意图
• PR 冲突 / CI 红：先 rebase 主线解决冲突，再从日志定位 lint 或测试失败点
• 被要求修改：按 review 意见逐条改，并附回复说明每处改动的理由

遇到流程彻底乱掉时，技能提供一条自救路径：先降级到练习仓库重新走一遍完整流程，再按 分支 → 改动 → 冲突 → CI 的顺序分层排查，改完后更新同一个 PR 而不是重开，并随手记一条这次踩的 Git 坑。

适用边界

• PR 能否合入取决于社区流程，技能不承诺「必过」
• 各项目的协作规范以该仓库 CONTRIBUTING 文件为准，技能提供的是通用协作框架
• 明确不鼓励刷无意义 PR，目标是真实的贡献积累