面向 Maintainer / Triager / Founder:用规则与自动化减少重复劳动,把 Founder 精力集中在高影响变更与发版。
| 原则 | 做法 |
|---|---|
| 公开优先 | 使用类问题 → Discussions;可跟踪缺陷 → Issue |
| 机器先行 | CI、Labeler、Dependabot、Stale 处理常规事务 |
| 域内自治 | docs/user-guide/**、单主题目录 PR 由文档/主题维护者合并 |
| 守门聚焦 | Founder 主要 Review CODEOWNERS 路径(lib/db、next.config.js、package.json 等) |
- 浏览 Discussions:
组织成员申请、未回复的「使用问答」。 - 扫一眼 Dependabot PR(可批量合并 patch/dev 依赖)。
- 合并队列:优先
documentation/good first issue且 CI 全绿 的 PR。 - 仅在发版窗口处理
package.json版本与 changelog。
Founder 可跳过第 3 步中纯文档 PR(若已授权文档维护者)。
| 用户诉求 | 动作 | 管理者耗时 |
|---|---|---|
| 「怎么部署/配置」 | 转 Discussions,关 Issue 或贴链接 | 1 条评论 |
| 重复 Issue | 关为 duplicate,链到已有 | 1 条评论 |
| 缺版本/环境信息 | 贴 bug 模板 要求补全,标 needs-info |
1 条评论 |
| 长期无回复 | 交给 Stale bot(45+14 天) | 0 |
| 安全漏洞 | 转 Private Advisory,勿公开讨论 | 按 SECURITY.md |
| PR 类型 | 标签/路径 | 谁合并 | CI 要求 |
|---|---|---|---|
| 纯文档 | documentation、docs/** |
任一 Write 维护者 | docs-site job |
| 单主题 | theme、themes/<name>/** |
主题维护者或 Write | lint + test |
| 依赖机器人 | dependencies |
维护者批量 | CI 绿 |
| 核心 / 配置 | core、config、CODEOWNERS |
Founder 或 2 人 Review | 全部 job |
禁止:未跑 CI 合并、Contributor 自合并自己的 PR(除非维护者明确授权)。
| 工具 | 作用 |
|---|---|
| ci.yml | PR:lint、type-check、test、lockfile、文档构建 |
| labeler.yml | 按路径打 documentation / theme / core 等标签 |
| dependabot.yml | 每周依赖 PR(默认跳过 major) |
| stale.yml | 45 天无活动标 stale,14 天后关闭 Issue |
| deploy-docs-site.yml | main 文档自动发布 |
| CODEOWNERS | 仅高影响路径 @Founder |
在 GOVERNANCE.zh-CN.md 基础上建议:
- Require status checks:
Lint & type-check、Unit tests、Lockfile consistency(文档 PR 可加VitePress build) - Require PR 进
main(Founder 亦走 PR,紧急 hotfix 例外并公告) - Allow auto-merge(可选):仅对 CI 绿且仅改
docs/**的 PR 启用 - Secret scanning + Dependabot alerts 开启
- 仓库标签与 labeler.yml 一致:
documentation、theme、core、config、dependencies、stale、needs-info、good first issue、help wanted - Issue 模板勿默认 assign 给 Founder(已移除
assignees)
- 确认
mainCI 绿。 - 更新
docs/user-guide/changelog/latest.md。 - 由 Org Admin 打 tag / Release,或运行
bump-version-on-main(仅维护者)。 - Discussion 公告 一条即可。