governance-content-scanner

name	governance-content-scanner
description	Scans web content for open source governance elements (CLA, SIG, Code of Conduct, etc.). Invoke when user requests governance check, CLA/SIG detection, or open source compliance review for web pages.

Open Source Governance Content Scanner

扫描网页内容，检测开源项目治理相关内容，包括 CLA、SIG、行为准则等治理要素。

检测范围

1. CLA (Contributor License Agreement) 贡献者许可协议

CLA是贡献者与开源项目之间的重要法律协议，用于明确贡献内容的知识产权归属和使用许可。

1.1 CLA 类型检测

检测项	关键词	说明
CLA 文档	Contributor License Agreement, CLA, contributor-license-agreement	贡献者许可协议
DCO	Developer Certificate of Origin, DCO, Signed-off-by	开发者原创证书
CLA 签署服务	ClaHub, CLA Assistant, EasyCLA, cla-bot	CLA 自动化工具

1.2 签署主体类型检测

签署类型	关键词	说明
个人CLA	Individual CLA, ICLA, 个人贡献者协议	以个人身份签署
企业CLA	Corporate CLA, CCLA, 企业贡献者协议	以企业身份签署
员工CLA	Employee CLA, 员工贡献者协议	以企业员工身份签署

1.3 CLA 内容完整性检测

检测CLA协议是否包含以下必要条款：

条款类型	关键词	说明	必要性
签署主体信息	signer, contributor, 签署者, 贡献者	明确签署者身份信息	必需
著作权授予	copyright, 著作权, 版权授予	授予著作权给项目拥有者	必需
专利权授予	patent, 专利, 专利许可	授予专利权给项目	必需
授权保证	warrant, 保证, 有权授予	签署者保证有权授予许可	必需
原创保证	original, 原创, original work	保证贡献为原创作品	必需
免责条款	disclaimer, warranty, 免责, 无担保	贡献内容免责声明	必需
非原创处理	third-party, non-original, 第三方, 非原创	提交非原创作品的处理方法	推荐
通知义务	notify, notice, 通知, 及时通知	不准确事实的通知义务	推荐
开源协议声明	license, 许可协议, 开源协议	阐述项目采用的开源协议	必需

1.4 CLA 检测评分标准

评分	条件
⭐⭐⭐⭐⭐	包含所有必需条款 + 推荐条款，区分个人/企业签署
⭐⭐⭐⭐	包含所有必需条款，区分个人/企业签署
⭐⭐⭐	包含大部分必需条款
⭐⭐	CLA存在但条款不完整
⭐	仅提及CLA但无具体内容

2. SIG (Special Interest Group) 特别兴趣小组

检测项	关键词	说明
SIG 组织	Special Interest Group, SIG, sig-	特别兴趣小组
工作组	Working Group, WG, working-group	工作组
兴趣小组列表	SIG list, SIGs, Active SIGs	SIG 列表页面
SIG 治理	SIG Charter, SIG Governance	SIG 章程/治理

3. Code of Conduct (CoC) 社区行为准则

社区行为准则是开源社区维护健康、包容、安全协作环境的重要文档，明确社区成员的行为规范和违规处理机制。

3.1 行为准则位置检测

检测项	关键词/路径	说明	必要性
根目录文件	CODE_OF_CONDUCT.md, code-of-conduct.md	项目根目录，位置显著	必需
.github目录	.github/CODE_OF_CONDUCT.md	GitHub标准位置	推荐
README链接	README中包含行为准则链接	易于查找	必需
网站导航	社区网站导航栏包含链接	易于访问	推荐

3.2 行为准则内容完整性检测

检测项	关键词	说明	必要性
行为范围	行为, behavior, expected, unacceptable	明确适用的行为范围	必需
参与者范围	participant, member, contributor, 社区成员	明确适用的参与者成员范围	必需
违规处罚	violation, consequence, penalty, 处罚, 后果	明确违规行为如何处罚	必需
举报方式	report, contact, email, 举报, 联系方式	有合理的举报违规行为的方式	必需
约束措施	ban, warning, timeout, kick, 禁止, 警告	违反准则者的约束措施	必需
回应机制	response, investigation, 处理, 调查	社区对举报行为的回应机制	必需
结果公示	public, announce, 公示, 公告	对处理结果进行公示	推荐

3.3 行为准则版本检测

版本	关键词	说明
Contributor Covenant 1.4	Contributor Covenant, 1.4	参与者公约1.4版本
Contributor Covenant 2.0	Contributor Covenant, 2.0, 2.1	参与者公约2.0/2.1版本
Mozilla CoC	Mozilla Community Participation Guidelines	Mozilla社区参与指南
Ubuntu CoC	Ubuntu Code of Conduct	Ubuntu行为准则
Apache Way	Apache Way, Apache Code of Conduct	Apache行为准则

3.4 行为准则评分标准

评分	条件
⭐⭐⭐⭐⭐	位置显著 + 内容完整 + 使用标准版本 + 有举报和处罚机制
⭐⭐⭐⭐	位置显著 + 内容完整 + 有举报和处罚机制
⭐⭐⭐	位置显著 + 包含基本行为规范
⭐⭐	行为准则存在但位置不显著或内容不完整
⭐	仅提及行为准则但无具体内容

4. Community Diversity (社区组织多样性)

社区组织多样性是衡量开源项目健康度的重要指标，体现项目的开放性和包容性。主要贡献者来自不同国家或组织，有助于项目获得多元化的视角和更广泛的生态支持。

4.1 贡献者地域多样性检测

检测项	关键词/指标	说明	必要性
贡献者国家分布	contributors, authors, 地理分布	贡献者来自不同国家/地区	必需
时区分布	timezone, 时区, 地区	贡献者时区分布广泛	推荐
语言多样性	language, 语言, 多语言	文档支持多种语言	推荐

4.2 贡献者组织多样性检测

检测项	关键词/指标	说明	必要性
组织分布	company, organization, 公司, 组织	贡献者来自不同组织/公司	必需
企业参与度	corporate, enterprise, 企业参与	多家企业参与贡献	推荐
个人与企业比例	individual, corporate, 个人贡献	个人与企业贡献者比例合理	推荐

4.3 多样性指标评估

指标	计算方式	说明
国家数量	统计贡献者所在国家数量	≥5个国家为优秀
组织数量	统计贡献者所属组织数量	≥3个组织为优秀
贡献集中度	主要贡献者贡献占比	≤50%为健康
新贡献者比例	新贡献者占比	≥20%为活跃

4.4 多样性评分标准

评分	条件
⭐⭐⭐⭐⭐	贡献者来自≥10个国家 + ≥5个组织 + 贡献集中度≤40%
⭐⭐⭐⭐	贡献者来自≥5个国家 + ≥3个组织 + 贡献集中度≤50%
⭐⭐⭐	贡献者来自≥3个国家 + ≥2个组织
⭐⭐	贡献者来自≥2个国家或组织
⭐	贡献者主要来自单一国家或组织

4.5 多样性数据来源

数据来源	获取方式	说明
Git提交记录	分析提交者邮箱域名	推断组织归属
GitHub/GitCode API	获取用户profile信息	包含公司、位置信息
贡献者文档	CONTRIBUTORS, AUTHORS 文件	明确列出贡献者信息
贡献统计页面	项目贡献统计页面	可视化展示多样性

5. 其他治理要素

检测项	关键词	说明
贡献指南	Contributing Guidelines, CONTRIBUTING, How to Contribute, 贡献指南, 贡献路径	贡献指南

扫描工作流程

┌─────────────────────────────────────────────────────────────────┐
│           Governance Content Scan Workflow                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Step 1: Fetch Web Content                                      │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 获取网页内容 → 提取文本和链接                              │   │
│  └─────────────────────────────────────────────────────────┘   │
│                           ↓                                     │
│  Step 2: CLA Detection                                         │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 检测 CLA/DCO 相关内容和签署流程                           │   │
│  └─────────────────────────────────────────────────────────┘   │
│                           ↓                                     │
│  Step 3: SIG Detection                                         │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 检测 SIG/工作组 组织结构和活动                            │   │
│  └─────────────────────────────────────────────────────────┘   │
│                           ↓                                     │
│  Step 4: Code of Conduct Detection                             │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 检测行为准则位置、内容完整性和处罚机制                     │   │
│  └─────────────────────────────────────────────────────────┘   │
│                           ↓                                     │
│  Step 5: Community Diversity Detection                         │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 检测贡献者地域和组织多样性                                 │   │
│  └─────────────────────────────────────────────────────────┘   │
│                           ↓                                     │
│  Step 6: Other Governance Detection                            │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 检测贡献指南                                             │   │
│  └─────────────────────────────────────────────────────────┘   │
│                           ↓                                     │
│  Step 7: Link Analysis                                         │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 分析相关链接 → 检测贡献指南链接                           │   │
│  └─────────────────────────────────────────────────────────┘   │
│                           ↓                                     │
│  Step 8: Generate Report                                       │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 汇总检测结果 → 生成治理要素报告                           │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

检测模式

CLA 检测模式

# CLA 关键词
(?i)(contributor[_-]?license[_-]?agreement|CLA|contributor[_-]?agreement)

# DCO 关键词
(?i)(developer[_-]?certificate[_-]?of[_-]?origin|DCO|signed[_-]?off[_-]?by)

# CLA 服务
(?i)(clahub|cla[_-]?assistant|easycla|cla[_-]?bot|cla[_-]?system)

# 签署主体类型
(?i)(individual[_-]?cla|ICLA|个人贡献者协议|个人CLA)
(?i)(corporate[_-]?cla|CCLA|企业贡献者协议|企业CLA)
(?i)(employee[_-]?cla|员工贡献者协议|员工CLA)

# CLA 必要条款检测
# 签署主体信息
(?i)(signer|contributor|签署者|贡献者信息|签名者)

# 著作权授予
(?i)(copyright|著作权|版权授予|版权许可|grant.*copyright)

# 专利权授予
(?i)(patent|专利权|专利许可|grant.*patent|专利授权)

# 授权保证
(?i)(warrant|保证有权|有权授予|legal.*right|授权权利)

# 原创保证
(?i)(original[_-]?work|原创作品|原创保证|original.*contribution)

# 免责条款
(?i)(disclaimer|warranty|免责声明|无担保|as[_-]?is|no[_-]?warranty)

# 非原创处理
(?i)(third[_-]?party|非原创|第三方代码|external.*code|notice.*required)

# 通知义务
(?i)(notify|notice|及时通知|inform|update.*information)

# 开源协议声明
(?i)(license|许可协议|开源协议|open[_-]?source[_-]?license|under.*license)

SIG 检测模式

# SIG 关键词
(?i)(special[_-]?interest[_-]?group|SIG|sig[_-]\w+)

# 工作组
(?i)(working[_-]?group|WG|working[_-]?team|task[_-]?force)

# SIG 治理
(?i)(sig[_-]?charter|sig[_-]?governance|sig[_-]?members|sig[_-]?leaders)

Code of Conduct 检测模式

# 行为准则文件名
(?i)(code[_-]?of[_-]?conduct|CoC|CODE_OF_CONDUCT)

# 行为准则版本
(?i)(contributor[_-]?covenant|参与者公约)
(?i)(mozilla[_-]?community[_-]?participation|ubuntu[_-]?code[_-]?of[_-]?conduct)
(?i)(apache[_-]?way|apache[_-]?code[_-]?of[_-]?conduct)

# 行为范围
(?i)(expected[_-]?behavior|unacceptable[_-]?behavior|行为规范|不当行为)
(?i)(our[_-]?standards|community[_-]?standards|社区标准)

# 参与者范围
(?i)(participant|member|contributor|社区成员|参与者)
(?i)(who[_-]?this[_-]?applies[_-]?to|适用范围)

# 违规处罚
(?i)(violation|consequence|penalty|处罚|后果|违规)
(?i)(enforcement|执行|强制措施)

# 举报方式
(?i)(report|contact|email|举报|联系方式|reporting)
(?i)(how[_-]?to[_-]?report|reporting[_-]?guidelines)

# 约束措施
(?i)(ban|warning|timeout|kick|禁止|警告|封禁)
(?i)(temporary[_-]?ban|permanent[_-]?ban|临时禁言|永久封禁)

# 回应机制
(?i)(response|investigation|处理|调查|回应)
(?i)(we[_-]?will|community[_-]?will|社区将)

# 结果公示
(?i)(public|announce|公示|公告|公开)
(?i)(transparency|透明|公开处理)

Community Diversity 检测模式

# 贡献者信息
(?i)(contributors|authors|贡献者|参与者列表)
(?i)(all[_-]?contributors|contributor[_-]?list)

# 地域多样性
(?i)(country|国家|region|地区|location|位置)
(?i)(timezone|时区|geo|地理分布)

# 组织多样性
(?i)(company|公司|organization|组织|employer|雇主)
(?i)(corporate|企业|enterprise|business)

# 多样性指标
(?i)(diversity|多样性|inclusivity|包容性)
(?i)(distribution|分布|statistics|统计)

# 贡献统计
(?i)(contribution[_-]?stats|贡献统计|contributor[_-]?stats)
(?i)(insights|洞察|analytics|分析)

其他治理模式

# 贡献指南
(?i)(contributing|how[_-]?to[_-]?contribute|contribution[_-]?guidelines|贡献指南|贡献路径)

链接检测

检测以下常见贡献指南文档路径：

文档类型	常见路径
CLA	/cla, /CONTRIBUTING, /doc/cla, /.github/CLA
行为准则	/CODE_OF_CONDUCT, /code-of-conduct, /.github/CODE_OF_CONDUCT
贡献指南	/CONTRIBUTING, /contributing, /.github/CONTRIBUTING

报告格式

# 开源治理内容扫描报告

## 扫描信息
- **扫描目标**: <URL>
- **扫描时间**: <时间戳>
- **页面标题**: <标题>

## 检测结果摘要

| 治理要素 | 检测状态 | 详情 |
|----------|----------|------|
| CLA/DCO | ✅ 已找到 / ❌ 未找到 | <详情> |
| SIG/工作组 | ✅ 已找到 / ❌ 未找到 | <详情> |
| 行为准则 | ✅ 已找到 / ❌ 未找到 | <详情> |
| 社区多样性 | ✅ 已找到 / ❌ 未找到 | <详情> |
| 贡献指南 | ✅ 已找到 / ❌ 未找到 | <详情> |

## 详细发现

### 1. CLA (Contributor License Agreement)

**状态**: ✅ 已检测到

**评分**: ⭐⭐⭐⭐⭐

**签署类型**:
| 类型 | 状态 | 签署链接 |
|------|------|----------|
| 个人CLA (ICLA) | ✅ 支持 | [签署链接] |
| 企业CLA (CCLA) | ✅ 支持 | [签署链接] |
| 员工CLA | ✅ 支持 | [签署链接] |

**条款完整性检测**:
| 条款类型 | 检测状态 | 说明 |
|----------|----------|------|
| 签署主体信息 | ✅ 已包含 | 明确签署者身份信息 |
| 著作权授予 | ✅ 已包含 | 授予著作权给项目拥有者 |
| 专利权授予 | ✅ 已包含 | 授予专利权给项目 |
| 授权保证 | ✅ 已包含 | 签署者保证有权授予许可 |
| 原创保证 | ✅ 已包含 | 保证贡献为原创作品 |
| 免责条款 | ✅ 已包含 | 贡献内容免责声明 |
| 非原创处理 | ✅ 已包含 | 提交非原创作品的处理方法 |
| 通知义务 | ✅ 已包含 | 不准确事实的通知义务 |
| 开源协议声明 | ✅ 已包含 | 项目采用的开源协议 |

**开源协议**: Apache-2.0 / MIT / GPL-3.0 / ...

**相关链接**: [CLA 文档](...)

### 2. SIG (Special Interest Group)

**状态**: ✅ 已检测到

**发现内容**:
- SIG 数量: X 个
- SIG 列表:
  - sig-architecture: 架构组
  - sig-network: 网络组
  - ...
- 相关链接: [SIG 列表](...)

### 3. Code of Conduct (社区行为准则)

**状态**: ✅ 已检测到

**评分**: ⭐⭐⭐⭐⭐

**位置检测**:
| 检测项 | 状态 | 说明 |
|--------|------|------|
| 根目录文件 | ✅ 已找到 | 位置显著，易于查找 |
| README链接 | ✅ 已包含 | 易于阅读 |
| 网站导航 | ✅ 已包含 | 易于访问 |

**内容完整性检测**:
| 检测项 | 状态 | 说明 |
|--------|------|------|
| 行为范围 | ✅ 已明确 | 明确适用的行为范围 |
| 参与者范围 | ✅ 已明确 | 明确适用的参与者成员范围 |
| 违规处罚 | ✅ 已明确 | 明确违规行为如何处罚 |
| 举报方式 | ✅ 已提供 | 有合理的举报违规行为的方式 |
| 约束措施 | ✅ 已提供 | 违反准则者的约束措施 |
| 回应机制 | ✅ 已明确 | 社区对举报行为的回应机制 |
| 结果公示 | ✅ 已明确 | 对处理结果进行公示 |

:
 使用版本: Contributor Covenant 2.0
 版本链接: []()

: []()



: ✅ 已检测到

: ⭐⭐⭐⭐⭐

:
| 检测项 | 状态 | 数值 | 说明 |
|--------|------|------|------|
| 贡献者国家数量 | ✅ | 12 | 贡献者来自12个国家 |
| 时区分布 | ✅ | 8个时区 | 覆盖主要时区 |
| 语言支持 | ✅ | 3种语言 | 文档支持多语言 |

:
| 检测项 | 状态 | 数值 | 说明 |
|--------|------|------|------|
| 参与组织数量 | ✅ | 6 | 6个组织参与贡献 |
| 企业参与度 | ✅ | 4家企业 | 多家企业参与 |
| 个人与企业比例 | ✅ | 40:60 | 比例合理 |

:
| 指标 | 数值 | 评估 | 说明 |
|------|------|------|------|
| 国家数量 | 12 | ⭐⭐⭐⭐⭐ | ≥10个国家，优秀 |
| 组织数量 | 6 | ⭐⭐⭐⭐⭐ | ≥5个组织，优秀 |
| 贡献集中度 | 35% | ⭐⭐⭐⭐⭐ | ≤40%，健康 |
| 新贡献者比例 | 25% | ⭐⭐⭐⭐ | ≥20%，活跃 |

:
| 组织 | 贡献者数量 | 贡献占比 | 国家/地区 |
|------|------------|----------|-----------|
| 组织A | 15 | 30% | 中国 |
| 组织B | 10 | 20% | 美国 |
| 组织C | 8 | 16% | 德国 |
| 个人贡献者 | 17 | 34% | 多国 |

: [](), []()



| 要素 | 状态 | 位置/链接 |
|------|------|-----------|
| 贡献指南 | ✅ | []() |



| 维度 | 评分 | 说明 |
|------|------|------|
| 贡献流程 | ⭐⭐⭐⭐⭐ | CLA + 贡献指南完善 |
| 社区组织 | ⭐⭐⭐⭐ | SIG 结构清晰 |
| 行为规范 | ⭐⭐⭐⭐⭐ | 行为准则完善 |
| 社区多样性 | ⭐⭐⭐⭐⭐ | 贡献者来自多国家多组织 |

: ⭐⭐⭐⭐ (4/5)



 ✅ CLA 机制完善，建议保持
 ✅ SIG 组织结构清晰
 ✅ 社区多样性良好，贡献者来自多个国家和组织

使用示例

示例 1: 扫描开源社区页面

User: 扫描 https://kubernetes.io/community/ 的治理内容
Action:
1. 获取页面内容
2. 检测 CLA/SIG 等治理要素
3. 分析相关链接
4. 生成治理报告

示例 2: 扫描项目仓库页面

User: 检查 https://github.com/apache/kubernetes 是否有完善的治理结构
Action:
1. 获取 README 和社区页面
2. 检测贡献指南链接
3. 检测 CLA/DCO 配置
4. 生成治理评估报告

示例 3: 批量扫描多个页面

User: 扫描以下项目的治理内容：
- https://openeuler.org/zh/community/
- https://www.openeuler.org/zh/community/committee.html
- https://gitee.com/openeuler/community

Action:
1. 逐个获取页面内容
2. 检测各治理要素
3. 汇总生成综合报告

常见开源社区治理模式

Kubernetes 模式

• SIG 组织结构
• KEPC 提案流程
• Contributor Ladder

Apache 模式

• PMC 治理
• Apache Way
• 投票机制

CNCF 模式

• TOC (Technical Oversight Committee)
• Sandbox/Incubating/Graduated
• 项目生命周期

openEuler 模式

• 技术委员会
• SIG 组
• 社区选举

注意事项

1. 内容获取: 使用 WebFetch 工具获取网页内容
2. 编码处理: 注意处理不同编码的网页
3. 动态内容: 部分内容可能通过 JavaScript 加载，需要特殊处理
4. 链接验证: 检测到的链接需要验证是否可访问
5. 误报排除: 排除示例、测试内容中的误报