GitHub 趋势 · 第 49 期

29,686 star 的 Mojo 仓库里，最该读的是一份 AI 使用政策

#AI协作规范#Mojo1.0#开源治理

先给个背景，免得你以为是哪个小项目在标新立异。Modular 是 Chris Lattner 创办的公司，Chris Lattner 是 LLVM 和 Swift 的创造者。这个仓库托管 Modular 平台的开源部分，主要两块：MAX（高性能推理服务器，提供 OpenAI 兼容端点）和 Mojo（他们自己造的新语言，介于 Python 和系统编程之间）。

一、先讲讲它想解决的那个问题

这份政策文档开头自己写了一句：This is a living document.（这是个活文档）—— AI 工具和社区惯例变得快，他们预期会持续修订，重大变更会在社区论坛公告，全部改动可以在 commit history 里查。把「规则会变」写进规则本身，这一步已经比很多项目坦诚。

二、它到底规定了哪几条

有几条容易被忽略的细节。标签要求覆盖的范围不只是代码：RFC、设计提案、issue、安全漏洞报告、以及 PR 上的评论，都算。而 PR 体积那条政策里专门留了一句：「don’t exclude the tests or docstrings」 —— 小是指别夹带无关改动，不是指可以砍测试。

官方给的标签长这样：

Assisted-by: AI

还有一条我认为是这份文件里最有分量的话，单独拎出来：

AI expands your capabilities; it does not outsource your judgment.

「AI 扩展你的能力，但它不外包你的判断。」这句话没有出现在任何技术文档里，而是出现在贡献政策的 Philosophy 一节。

三、最狠的一条：它承认规则是主观的

大多数贡献指南会假装自己能给出客观标准 —— 多少行算大、什么算重复劳动。这份没有。它在解释完「什么算攫取式贡献」之后，直接写了这么一段：

These factors cannot be weighed objectively. Our policy leaves this
determination to the maintainers doing the work of sustaining the project.

「这些因素无法被客观衡量。我们的政策把判断权交给那些在做维护工作的人。」接着它才给出可以被验证的那一条黄金法则：

那段模板是原文给的，我没改一个字：

This PR doesn’t appear to comply with our policy on AI-generated content,
and requires additional justification for why it is valuable enough to the
project for us to review it. Please see our AI tool use policy:
https://github.com/modular/modular/blob/main/AI_TOOL_POLICY.md

政策里还引了 Nadia Eghbal 在《Working in Public》里对「攫取式贡献」的定义，并且把话说得很清楚：在 LLM 出现之前，维护者往往愿意审任何一份贡献，因为提交一个 PR 本身就代表着这个人有兴趣成为长期贡献者；AI 工具改变了这个信号 —— 它把工作量从实现者身上挪到了评审者身上。所以他们要保护的是维护者的时间。

还有一句，针对的是「把维护者的反馈原样喂给 LLM 再提交回来」这种操作：

Passing maintainer feedback directly to an LLM and resubmitting doesn’t
help anyone grow, and does not sustain our community.

四、一个很少见的小节：Copyright

贡献指南里写版权一节的项目不多，专门写「AI 与版权」的就更少。它的立场只有一句核心：

这一节的措辞是「AI systems raise unsettled questions around copyright」（AI 系统在版权上抛出了尚未落定的问题），也就是说它没有假装自己解决了争议，只是把「你得自己负责」这条兜底责任明确地压回到提交者身上。

五、它不是凭空写的：参考了五个项目的实践

文件末尾的 References 一节，把每一处借鉴都标注了来源和访问日期，这在贡献政策里相当罕见：

• ▪LLVM AI Tool Policy（访问于 2026-02-20，Apache-2.0 with LLVM Exceptions）—— 政策的结构和很大一部分文字都改编自它。LLVM 是 Chris Lattner 的老地方，这个借鉴路径很好理解。
• ▪Fedora Council 的政策提案（Policy on AI-Assisted Contributions）—— 部分内容取自它，该提案本身以 CC BY 4.0 授权，文中以链接方式完成署名。
• ▪Rust 关于「负担沉重的 PR」的草案政策（rust-lang/compiler-team issue 893）。
• ▪QEMU 禁用 AI 内容生成器 —— 这是最硬的一档处理方式，直接禁用。
• ▪Seth Larson 关于 Python 生态「slop 安全报告」的文章，以及 Simon Willison 在 2024 年给这种现象起的名字：slop。

值得玩味的是这几档的态度差别：LLVM 借鉴、Fedora 提案、Rust 讨论、QEMU 直接禁、Simon Willison 负责命名。Modular 选的是中间偏严的那档 —— 不禁止，但要你署名、要你小、要你自己写描述、要你人在环内。

另外，这份政策也明确禁止「没有人类批准就替你在项目空间行动」的 agent。这一点和它的另一面形成了很妙的对照 —— 下一节说。

六、同一个仓库的另一面：它给 agent 也开了门

如果你只看 README，会觉得这就是个普通开源仓库。但把根目录列一遍就会发现，它同时准备了两套「说明书」：一套给人，一套给 agent。

那个 9 字节的 AGENTS.md 值得停一下。它是为了让各种 agent 工具都能自动读到同一份指引，所以只放一个文件名做跳转。也就是说这个项目连「给 agent 的入口」都做成了指针文件。

更彻底的是 CLAUDE.md 的最后一节，标题叫 LLM-friendly documentation，直接列了十个端点，把文档按文本形式喂给模型：

https://max.modular.com/llms.txt
https://max.modular.com/llms-max-guides.txt
https://max.modular.com/llms-python.txt
https://max.modular.com/llms-accelerator-api.txt
https://max.modular.com/llms-c-api.txt
https://max.modular.com/releases-llms.txt
https://mojolang.org/llms.txt
https://mojolang.org/llms-full.txt
https://mojolang.org/llms-stdlib.txt
https://mojolang.org/llms-manual.txt

官方另有一个独立仓库 modular/skills，在最新版 release 说明里点名了为本轮模型上线工作流新增的四个技能：serve-model、benchmark-model、eval-model、profile-model，另有保持语法对齐的 mojo-syntax。这个是本系列第几次遇到「仓库自带 agent 技能」我已经数不清了，但趋势很清楚：项目不再只给人读，也开始给 agent 读。

七、仓库本体：两个版本号，指同一个 commit

技术部分也说清楚。这个仓库最新正式版本是 max/v26.5.0，发布日期 2026-08-11，release 标题写着 「MAX 26.5 / Mojo 1.0.0」，在 GitHub 上 prerelease 为 false，是正式版。

关于 1.0 这件事，官方口径克制得值得抄下来：他们才刚刚开始把标准库 API 标记为稳定，而且只是一小部分。release 说明原文是 we started with a small set that we’ll grow in subsequent 1.x releases。这次发布的破坏性改动比平时多，但官方承诺 nearly every breaking change ships with a deprecated alias and a compiler fix-it, so migration is mechanical —— 几乎每个破坏性改动都配了废弃别名和编译器自动修复，所以迁移是机械性的。

顺带提一句许可，这块容易看错。README 的 License 一节明确切成了两层：

• ▪This repository and its contributions are licensed under the Apache License v2.0 with LLVM Exceptions —— 仓库和它的贡献走 Apache-2.0 + LLVM 例外。
• ▪MAX usage and distribution are licensed under the Modular Community License —— 但 MAX 的使用与分发另有条款。
• ▪还有一条第三方声明：You are entirely responsible for checking and validating the licenses of third parties。

另外，max/CONTRIBUTING.md 里有一张按代码路径划分的贡献状态表，其中 max/include/max/c 一行的描述写着 Closed source bindings，状态 N/A。也就是说这个开源仓库里存在明确的闭源绑定目录，开源边界是划好的、写出来的，而不是靠猜。

八、上手：装 Mojo，和跑 MAX

仓库 README 本身不给安装命令，只有一句「看官方文档」。下面命令取自项目自己的文档站与仓库内的 CLAUDE.md，原文照抄。

用 Mojo（官方 quickstart，推荐 pixi 或 uv，这里走 uv 路线）：

curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install mojo

# 或者建一个项目再装
uv init temperature-analyzer
cd temperature-analyzer
uv add mojo

# 跑起来
mojo analyzer.mojo

要让 AI 助手跟上最新语法，官方给了一条：

npx skills add modular/skills

用 MAX 起一个 OpenAI 兼容的推理服务，命令来自仓库里的 CLAUDE.md：

pip install "max[serve]" --extra-index-url https://whl.modular.com/nightly/simple/

max serve --model modularai/Llama-3.1-8B-Instruct-GGUF

# 或者用 Docker
docker run --gpus=1 -p 8000:8000 docker.modular.com/modular/max-nvidia-full:latest \
    --model modularai/Llama-3.1-8B-Instruct-GGUF

平台支持这块，两处口径不一样，但指的是不同的事，别混：用 Mojo 本身，官方 quickstart 写的是 You can use Mac, Linux, or Windows with WSL；而往这个仓库贡献代码，CLAUDE.md 明确列为 Linux x86_64 / aarch64、macOS ARM64，Windows: Not currently supported。

九、我的判断

十、数据脚注

最后一件事值得说：这份 AI 政策本身也是用 AI 政策允许的方式在演进 —— 它是 living document，改动全在 commit history 里。如果你团队里正在为「AI 写的代码怎么算数」吵架，把一个链接甩过去比吵一小时有用。

你在项目里见过更严或者更聪明的 AI 协作规定吗？或者你觉得「必须自己写 PR 描述」这条在你们团队能落地吗？留言聊聊。

下期预告：NVIDIA-NeMo/Switchyard（本月 +2,628）—— 一个保持 OpenAI 与 Anthropic 原生 API 兼容的路由层，在多模型与多供应商之间做流量分配和成本优化。备选 Tencent/WeKnora（22,297 star，周榜 +815，Go），开源 LLM 知识平台。

#AI协作规范#Mojo1.0#开源治理