SQLite 的 AGENTS.md：当开源项目开始给 AI 立规矩

起因：一份给 AI 看的“使用说明”

五天前，著名的嵌入式数据库 SQLite 的代码库里多了一个名为 AGENTS.md 的文件。这并非项目自身的开发文档，而是一份明确写给那些可能使用 AI 编码代理（如 Devin、Cursor Composer 等）来分析或修改 SQLite 代码的开发者的“行为准则”。文件的核心信息很直接：SQLite 不接受未经事先同意的拉取请求（Pull Request），尤其不接受由 AI 代理生成的代码。然而，项目欢迎附带可复现测试用例的 AI 生成错误报告。最近一次提交甚至删除了“当前”一词，强化了“不接受”的立场。与此同时，SQLite 论坛正被大量质量参差不齐的 AI 生成错误报告淹没，迫使项目将它们分流到一个全新的“SQLite 错误论坛”。

拆解：规则背后的信号

这不仅仅是一个技术声明，更是一个清晰的信号。SQLite 维护者 D. Richard Hipp 和团队用行动划定了边界。他们区分了两种 AI 产出：代码贡献 和 错误报告。对于前者，他们持谨慎甚至排斥的态度，原因可能包括代码质量、版权归属（要求贡献置于公共领域）以及维护者宝贵的审查时间。对于后者，他们持有限欢迎态度——前提是报告质量高，能附带一个可复现的测试用例，这能有效帮助定位问题。将错误报告分流到独立论坛，是一个务实的工程管理决策，旨在保护核心开发者不被信息洪流淹没，确保有效的信号（真实的、高质量的错误报告）能被听到。

趋势洞察：从“技术适配”到“社会契约”

这件事揭示了一个比技术更深的趋势：AI 编码代理的普及，正在迫使开源社区从技术层面的适配，转向建立社区协作层面的新规则。过去，我们讨论的是“如何让 AI 更好地理解代码库”（RAG、微调等）。现在，问题变成了“当 AI 能大规模生成代码和报告时，人类维护者该如何应对？”SQLite 的 AGENTS.md 就是这种新“社会契约”的雏形。它明确告诉 AI 代理的使用者：“你可以用你的工具，但请遵守我们的游戏规则。”这预示着，未来重要的开源项目可能都需要一份类似的“AI 协作指南”，明确项目对 AI 生成内容的接受范围、格式要求和质量门槛。

实用价值：给开发者和项目维护者的启示

对于使用 AI 编码代理的开发者，这是一个重要的提醒：不要无脑提交 AI 的产出。在向任何开源项目提交贡献前，必须阅读并遵守其贡献指南，现在可能还需要专门查看是否有 AGENTS.md。你需要理解，你的 AI 代理生成的代码或报告，接收方是精疲力尽的人类维护者，质量低下或不符合规范的提交只会增加他们的负担，甚至可能被直接关闭。对于开源项目维护者，SQLite 提供了一个可参考的范本。如果你的项目也开始收到大量疑似 AI 生成的、质量不佳的贡献或报告，考虑像 SQLite 一样，制定明确的规则并进行分流管理，这可能是维持社区健康和开发效率的必要手段。

反常识：AI 带来的“帮助”可能是负担

一个可能被忽略的角度是：AI 让“贡献”变得极其容易，但这对项目来说未必是好事。过去，提交一个补丁需要开发者深入理解代码、手动编写、测试，这个过程本身是一种质量过滤。现在，AI 可以在几分钟内生成一个看似合理的补丁或错误报告。这种“低摩擦”的贡献，如果缺乏人类严格的审查和上下文理解，对维护者来说就成了纯粹的噪音和负担。SQLite 的案例生动地说明，技术的“赋能”若没有配套的“治理”，可能会适得其反。AI 放大了人类的能力，同时也放大了混乱。如何管理这种由 AI 带来的、指数级增长的“贡献”流量，是所有成功开源项目即将或正在面临的严峻挑战。

原文地址: sqlite AGENTS.md