无垃圾开源贡献最佳实践清单(使用AI或不使用)
一份关于在开源项目中如何避免“AI垃圾”贡献的检查清单,涵盖从理解项目到提交贡献的完整流程,强调信任建立与高质量贡献。
近年来,开源社区中出现了大量由AI生成的仓库和拉取请求(PR),这些往往缺乏明确的所有权,被称为“AI垃圾”。这种现象并非完全由AI引起;许多新加入的人类贡献者也不熟悉开源工作流和项目期望,AI工具有时会放大这些问题。这导致他们的贡献被淹没在噪音中,被维护者忽视。
为了解决这个问题,一份名为“No-Slop OSS”的清单应运而生。它专注于帮助贡献者建立信任并提交高质量的贡献,无论是否使用AI。清单共包含12项实践,从目的性贡献开始,强调创造价值而非追求可见性。
第一步是充分理解项目:阅读README、贡献指南和行为准则,研究项目的目标、架构和技术栈,浏览现有议题和讨论以把握社区优先事项。第二步是参与社区:在公开渠道介绍自己,提问前先搜索,遵循交流规范。第三步是彻底搭建环境:按照文档设置开发环境,安装依赖,配置预提交钩子和格式化工具。
关于AI政策,清单建议检查项目是否有AI贡献政策,若没有则主动披露。使用AI时,应将其作为工具而非替代品:用于头脑风暴、自动化重复任务或记录复杂过程,但绝不能未经逐行审查、充分测试和修改就提交AI生成的代码。
其他关键步骤包括:测试、验证和更新文档;从小型任务入手,如bug修复或文档改进;开始工作前确认无重复PR,并与维护者沟通;定期通报进展,保持响应。提交PR时需遵循模板,保持单一逻辑变更,撰写清晰提交信息,并在必要时进行AI披露和DCO签署。
最后,清单列出了禁忌:不要未经审查提交AI代码、忽视社区规范、未经讨论提交大变更、低质量刷屏等。维护者可以采用此清单作为NOSLOP.md文件。开源的成功不仅依靠代码,更依靠信任与协作。