Maintainer 指南

成为 maintainer 不是一场考试，而是一个开始。

很多项目把 maintainer 说得很神秘，好像要写过成千上万行代码、混很多年才够格。OryxOS 不是这样。 我们刚起步，正缺人一起把它撑起来。这里的门槛只有一句话：

只要你想动起来，就可以成为 committer。

我们真心希望你不只是提一两个 PR 就走，而是留下来，学会怎么评审别人的代码、怎么把关质量、怎么带新人——这才是 maintainer 真正值钱的能力，也是你能写进简历的东西。

角色阶梯

我们借用开源社区通用的三层角色，但把门槛放到最低：

角色	你能做什么	怎么到这里
Contributor（贡献者）	提 issue、提 PR、参与讨论	提第一个 PR 的那一刻，你就是了
Committer（提交者）	有评审权，能给别人的 PR 点 Approve，参与决策	持续贡献 + 开始 review 别人的 PR，由 maintainer 提名
Maintainer（维护者）	有合并权，管一块领域，带新人，参与发版	稳定贡献 + 稳定评审 + 对某个模块有 ownership

注意：这三层不是"熬资历"熬出来的，是"动起来"动出来的。 你越主动 review、越主动帮别人、越主动认领 issue，就升得越快。

怎么成为 Committer

我们刻意把这一步放得很轻。你不需要 KPI，也不需要谁的批准会拖上几个月。大致是这样：

1. 提几个被合并的 PR——数量不是关键，能看出你理解这个项目、代码认真就行。
2. 开始 review 别人的 PR——哪怕只是去别人 PR 下面认真看一遍、提一条具体意见、点个 LGTM。这一步最重要，它证明你开始从"写代码的人"转向"维护项目的人"。
3. 被提名——现有 maintainer 看到你在持续动、愿意帮别人，就会提名你为 committer。你也可以直接开个 issue 说"我想更深入参与，能给我 committer 吗"，我们欢迎主动。

就这么简单。我们宁可门槛低一点、多几个人动起来，也不想把有热情的人挡在门外。

怎么成为 Maintainer

Committer 再往前一步就是 maintainer。看的不是时间长短，而是这几样：

• 稳定的贡献——不是一阵风，而是持续在提交、在解决问题。
• 稳定的评审——你的 review 有质量，别人信得过你点的 Approve。
• 对某块有 ownership——比如你把 Tool 体系、或 Web 管理台、或文档站，当成"自己的地"在照看。
• 带新人——有人来提第一个 PR，你愿意花时间帮他改到能合并。

满足这些，现有 maintainer 会提名你、大家达成共识后，你就是 maintainer 了。

Maintainer 做什么

• 评审 PR：给出具体、友善、可执行的意见；满意了点 Approve / 回 LGTM。
• 合并 PR：确认 CI 全绿、拿到足够 Approve 后合入。
• 打理 Issue：分类、打标签、回复、把 good first issue 留给新人。
• 带新人：这是最重要的一件事。你今天帮的人，明天就是和你一起维护项目的人。
• 参与发版：跟着GitHub 贡献入门里的发布流程走（PR 标题 release: 触发自动发版）。
• 守住地基：安全、审计、沙箱、架构宪法这些底线，maintainer 帮忙把关（见 CLAUDE.md）。

权力与责任

拿到合并权，意味着你替这个项目对代码质量负责。所以：

• 合并前对得起自己的 Approve——CI 绿、评审到位、不破坏架构宪法。
• 对人始终友善——你是新人看到的"这个社区的样子"。你友善，社区就友善。
• 拿不准就拉人一起看——maintainer 不是要你什么都懂，是要你知道"什么时候该多找一双眼睛"。
• 对 AI 产物一视同仁——我们欢迎贡献者用 AI（见贡献指南）。评审时只认结果：代码对不对、测试过没过、作者能不能对它负责。别因为"是 AI 写的"就放松，也别因此更苛刻——标准只有一条，就是质量。

我们的承诺

• 我们主动提名、主动给权限，不让有热情的人干等。
• 我们把"学会做 maintainer"当成这个项目给你的回报之一——不只是学会写代码。
• 我们真心希望项目发展好。等它长大，你维护者的身份，就是简历上比"提过几个 PR"更重的一笔。

准备好了？先从贡献指南提第一个 PR，然后去别人的 PR 下面点第一个 LGTM。剩下的，我们一起走。