good-pr
Good PR 是一项帮助贡献者撰写和审查拉取请求(Pull Request)的技能,目标是让维护者真正愿意合并这些 PR。它的所有指导原则都来自对真实维护者痛点的反向总结——把会被关闭的贡献与能被合并的贡献区分开来。该技能强调:维护者必须为自己合并的每一行代码负责,因此贡献者的职责是让维护者的工作更轻松,而不是更困难,也就是要拿出证据证明改动正确,而非仅仅声明正确。技能提供了一份清单,涵盖复现步骤、视觉证据、符合项目风格的代码、能证明修复有效的测试、范围收敛且安全的改动、以及独立的 PR 描述等维度,并列举了常见的反模式。它还提供了配套的参考文档(PR 模板、示例、视觉证据指南、审查清单)和脚本(check-visual-evidence.py、check-pr-readiness.py),支持在提交前做自动化就绪性检查。适用于向开源项目或他人维护的代码库提交 PR、准备 PR 描述、自查改动质量以及审查他人 PR 等场景。