在参与 Codex 开源项目或团队协作时，理解并正确执行 Pull Request (PR) 流程是每位开发者的必修课。对于新手而言，这不仅是代码合并的通道，更是展示工作成果、接受同行评审的关键环节。本指南旨在帮助你从零开始，清晰、规范地完成第一次 PR 提交。
分支管理与代码提交
一切始于清晰的本地环境准备。首先，确保你的主分支与上游仓库保持同步，避免合并冲突。接着，为每个功能或修复创建一个独立的特性分支，命名应简洁明了，如 fix-login-bug 或 add-dashboard-ui。在编码完成后，务必进行本地测试，确保新代码符合项目的质量标准。提交时，遵循“原子化”原则，将相关的逻辑变更放在同一个 commit 中，并编写描述性强的提交信息，让审查者一眼就能看懂你的改动意图。
撰写高质量的 PR 描述
PR 标题和描述是沟通的核心。标题应概括核心变更，例如“修复用户登录时的空指针异常”。在正文中，你需要清晰地说明：为什么需要这个修改？它解决了什么问题？以及具体的实现方案。如果涉及 UI 变化，附上截图或动图能极大提升沟通效率。此外，记得关联相关的 Issue 编号，这样可以将代码变更与需求追踪紧密绑定，方便后续维护。
响应评审与最终合并
提交 PR 后，不要等待即可去忙别的事。积极的响应评审意见是专业素养的体现。当审查者提出建议时，及时在评论区回复，并通过新的 commit 或直接 push 来修正代码。若某些建议存在争议，应在评论中理性讨论而非沉默对抗。当所有检查通过且获得至少一名 maintainer 的批准（LGTM）后，即可点击合并按钮。最后，别忘了删除已合并的特性分支，保持仓库整洁。