开源项目治理模型编写

技能文档

---
name: slim-governance
title: 开源项目治理模型编写
category: 开发工具
description: 为开源项目创建治理模型与结构，内置小型/中型/大型团队三套治理模板，含政府或机构背书项目的合规要点。覆盖角色定义、决策流程、贡献者路径、冲突解决与治理演进。当用户需要为开源项目编写 GOVERNANCE.md、设计团队角色与决策机制、项目开源化时触发。触发词：开源治理、治理模型、GOVERNANCE、决策流程、贡献者指南。
---

# 开源项目治理模型编写

## 概述

为开源项目建立清晰的治理结构：保证透明度、鼓励贡献、维持技术标准、提供明确的决策流程。技能内置三套针对不同团队规模的治理模板（assets/ 目录），并针对政府或机构背书项目提供合规指引。

## 适用场景

- 启动新的开源项目，需要治理结构
- 私有项目开源化，需要配套治理
- 建立团队角色与决策流程
- 满足政府/机构背书项目的合规要求
- 团队规模扩大后的治理升级
- 明确贡献者路径与职责

## 团队规模评估

| 规模 | 特征 | 适用 |
|------|------|------|
| 小型（2-5 名活跃贡献者） | 全员直接沟通、决策简单、流程最少 | 早期项目、研究项目、小型工具 |
| 中型（6-20 名活跃贡献者） | 沟通半结构化、需要部分正式角色、多领域分工 | 成长期项目、多组件系统 |
| 大型（20+ 名活跃贡献者） | 需要正式沟通结构、多委员会/工作组、多利益相关方 | 企业级项目、多组织协作、成熟生态 |

## 技能工作流

### 步骤1：评估现状

回答五个关键问题：

1. **团队规模**：活跃贡献者数量？
2. **增长预期**：团队扩张速度？
3. **组织复杂度**：涉及多少个组织？
4. **决策复杂度**：典型技术决策的复杂程度？
5. **合规要求**：是否有政府/机构层面的要求？

### 步骤2：选择模板

- **小型模板**：≤5 人、单一组织主导、技术决策简单、需要快速迭代、偏好最少流程 → `assets/governance-small.md`
- **中型模板**：6-20 人、多组织参与、决策复杂度中等、兼顾速度与流程 → `assets/governance-medium.md`
- **大型模板**：20+ 人、多组织结构复杂、高风险技术决策、需要正式流程与社区治理 → `assets/governance-large.md`

拿不准时选更小的模板——增加复杂度比删减容易。

### 步骤3：部署前检查

```bash
ls -la GOVERNANCE.md GOVERNANCE/ governance/
```

若已有治理文档：先评审现有结构、规划迁移策略、为切换过程做版本记录，并提前向社区沟通变化。

### 步骤4：复制并定制模板

```bash
cp assets/governance-[small|medium|large].md GOVERNANCE.md
```

定制要点：

- 替换所有 `[INSERT...]` 占位符为项目信息（名称、领域、链接、联系人）
- 角色名对齐组织习惯；按需调整权限层级，可增设专职角色（如安全负责人、文档负责人），明确任期
- 决策机制：选择表决阈值（过半数/绝对多数/共识），定义升级路径、会议节奏与僵局打破机制
- 沟通渠道：指定讨论平台、哪些决策必须公开讨论、邮件组/论坛与会议频率

### 步骤5：团队评审与批准

- 内部评审：与现有团队过稿，收集对角色与流程的反馈，验证决策场景
- 利益相关方批准：取得发起方认可，必要时经法务/合规评审，记录修订

### 步骤6：社区引入

- 用 issue 或 discussion 公布治理模型：讲清收益、贡献者机会与过渡时间线
- 更新项目文档：README 链接到 GOVERNANCE.md，CONTRIBUTING.md 补充角色说明，官网与新成员引导纳入治理引用

### 步骤7：落地与演进

- 按定义的角色与流程运行，召开首次治理会议，启动贡献者引导
- 按季度收集治理效果反馈，按真实使用调整流程；团队扩张时同步升级治理规模并沉淀经验

## 政府/机构背书项目合规要点

涉及政府或机构背书（如科研机构、公立大学）的项目：

1. **机构要求**：包含规范的版权声明、引用机构政策、满足出口管制与安全指引
2. **角色定义**：纳入监管方角色，区分雇员与外包承包商职责，明确跨境参与规则，为敏感决策设置审批流
3. **文档标准**：满足机构档案留存要求，决策过程留痕可审计，遵循无障碍标准
4. **贡献规范**：实施贡献者许可协议（CLA）、建立知识产权审查流程、定义可接受的贡献来源与安全审查程序
5. **模板选择**：比评估结果选大一档的模板，确保合规章节完整填写

## 模板清单

- `assets/governance-small.md`：小团队精简治理（2-5 人）：贡献者 → 提交者 → 产品负责人三级角色、轻量决策流程
- `assets/governance-medium.md`：中型团队均衡治理（6-20 人）：增设技术指导委员会（TSC）、多路径审批、正式 RFC 流程
- `assets/governance-large.md`：大型团队完整治理（20+ 人）：多专门委员会、治理董事会、结构化提案与评审流程

所有模板均含：角色与职责、决策流程、贡献规范、冲突解决程序、可定制占位符。

## 最佳实践

1. **从简起步**：选择最小可行的治理结构
2. **渐进扩展**：只在团队规模需要时增加复杂度
3. **全程留痕**：治理决策保持清晰记录
4. **定期评审**：按季度评估治理有效性，首年后可转年度
5. **社区优先**：贡献者体验与透明度优先

**常见反模式**：过度工程（起步即复杂治理）、沟通不足（变更说不清楚）、流程僵化、角色重叠或模糊、治理不随团队演进。

## 常见问题

**Q：规模介于两档之间怎么选？**
A：选更小的模板起步，增加复杂度比删减容易。

**Q：组织有特定治理要求怎么办？**
A：以最接近的模板为起点，定制角色与流程满足组织要求。

**Q：可以混用不同模板的元素吗？**
A：可以。模板只是起点，按项目语境组合即可。

**Q：治理多久评审一次？**
A：首年按季度评审，之后每年一次或团队发生重大变化时评审。

使用说明

# 开源项目治理模型编写

为开源项目生成治理模型与结构：三套团队规模模板（小/中/大）、角色与决策机制设计、机构背书项目合规指引。

## 使用

```text
我们的项目有 8 个活跃贡献者、3 家组织参与，帮我生成 GOVERNANCE.md
```

```text
把现在这个私有仓库开源，需要一套治理结构
```

## 工作原理

先按五问评估团队规模与合规要求，从 assets/ 选择对应模板复制为 GOVERNANCE.md，替换占位符并定制角色、表决阈值与沟通渠道，再经团队评审、社区公布与季度迭代落地。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。