Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
158 changes: 158 additions & 0 deletions COMMUNITY_zh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
# 社区共建机制(试验期) 🤝

AgentScope-Java 是一个开放的开源社区,参与者可根据自己的时间、兴趣和熟悉领域自由参与。本文档定义了社区角色、职责与成长路径。

> 💡 关于如何提交 PR、提交信息规范等贡献流程,请参阅 [CONTRIBUTING_zh.md](./CONTRIBUTING_zh.md)。所有参与者应遵守社区行为准则。

## 贡献类型

欢迎以下各类贡献:代码提交、文档、测试、Issue 反馈与确认、PR Review、设计讨论、社区支持、版本发布与维护等。

---

## 角色与职责

### Contributor

- 提交 PR、Issue 或参与 Review 与设计讨论的社区成员。
- 认可范围:合入主分支的 PR、实质性 Review、被采纳的技术决策均计入贡献统计。

### Committer

- 拥有仓库写入权限,负责 PR 终审与合入,保障代码质量与项目一致性。
- 关注功能正确性、设计合理性、测试充分性、文档、安全、兼容性与依赖变更。

### PMC

- 项目管理与决策核心,负责路线图规划、版本发布与重大技术决策。
- 负责 Committer 提名与评议、社区治理,维护社区规范与行为准则。

---

## PR 审核规范

### 提交要求

- 每个 PR 应尽量只解决一个问题,并关联对应 Issue。
- 避免冗余的 AI 生成注释/样板代码,否则会影响项目的可维护性/可读性。
- 禁止通过拆分小 PR、格式化、无意义改动等方式刷贡献数。

### 重复与冲突检查

- 审核前检查是否已有多个 PR 解决同一问题,或一个 Issue 对应多个 PR。
- 发现重复 PR 时,应在相关 PR/Issue 中说明,建议关闭重复项,只保留最合适的一个。
- 最终只对合入主分支的 PR 计贡献。

### 审核流程

- 每个 PR 至少需要 1 位 Reviewer。中等以上 PR(定义见下)合入前至少需要 2 位 Reviewer 给出 `LGTM`,除非经核心维护者同意。
- Reviewer 应检查:功能正确性、设计合理性、测试充分性、文档、安全、兼容性、依赖变更等。
- 较大、重要、或拿不准的 PR,推荐在维护者群中讨论。
- 如发现问题,给予评论 / Request changes,并尽量给出具体修改意见。
- 贡献者修复完成后,Reviewer 再次审核;无问题则评论 `LGTM`。
- 只有具备写入权限的核心维护者可以合并 PR。

### 中等以上 PR 定义 ✅

- 主代码或功能逻辑变更超过 100 行(不包括测试、文档);
- 涉及公共 API、安全、依赖升级、构建系统;
- 影响多个模块或跨仓库。

### Review 有效性记录 📌

- 任何贡献者都可参与 Review PR,但必须对经手的代码负责(不要只依赖 AI,多思考原始问题对应的完整上下文)。
- 有效 Review 指:Reviewer 在完整跟进一个 PR 后,确认无问题并给出 `LGTM`。
- Reviewer 评论 `LGTM` 后,若核心维护者仍发现重大问题(或 PR 合并后出现重大回归),可取消该次 Review 计数。
- 合并 PR 前,核心维护者应将有效 Reviewer 添加到 Assignees,作为 Committer 评审依据(较大 PR、非测试/文档改动超过 500 行,可对 Reviewer 记两次有效 Review)。

---

## Committer 评审标准

### 提名时间

不固定时间,可以选择在社区周会上。

### 提名方式

- 自我推荐
- 核心维护者推荐

提名时需提供有效贡献记录,包括但不限于 PR 合入记录、Review 记录等。

### 评审标准

候选人需同时满足以下条件:

1. 3+ months 的社区活动和参与,对项目有深入的理解。
2. 累计 PR 合入 **20+**
3. 累计有效 Review **15+**
4. 有效贡献累计 **35+**(PR 次数和 Review 次数可适当置换)

不计入统计的情况:

- 被认定为重复、拆分、刷量或无效的 PR;
- 被核心维护者判定为无效的 Review。

### 评审流程

1. 核心维护者汇总并公示候选人名单及贡献统计;
2. PMC 或现有 Committer 进行评议;
3. 公示期 3 个工作日,无重大异议,正式授予 Committer 权限。

---

## PMC 评审标准

### 提名方式

- 由现有 PMC 成员提名;
- 或由社区推荐,并经 PMC 讨论。

### 评审标准

候选人需同时满足以下条件:

1. 已担任 Committer,有效贡献累计 **60+**,在社区累计贡献满 **8 个月**;
2. 近 6 个月 ≥10 次有效贡献
3. 主导或深度参与至少 **2 个**版本发布或重大技术决策;
4. 在社区协作、冲突处理、行为规范方面表现良好。

### 评审流程

1. 现有 PMC 进行评议;
2. 通过后公示 3 个工作日;
3. 无重大异议后,正式授予 PMC 角色。

---

## 成员名单

### PMC Members

|   | Member | Organization | Profile |
| -------------------------------------------------------------- | -------- | ------------ | ---------------------------------------- |
| <img width="30px" src="https://github.com/chickenlj.png"> | Jun Liu | Alibaba | [chickenlj](https://github.com/chickenlj) |

### PMC Emeritus members

| &nbsp; | Member | Organization | Profile |
| -------------------------------------------------------------- | ---------- | ------------ | ---------------------------------------------- |
| <img width="30px" src="https://github.com/AlbumenJ.png"> | AlbumenJ | Alibaba | [AlbumenJ](https://github.com/AlbumenJ) |
| <img width="30px" src="https://github.com/LearningGp.png"> | LearningGp | Alibaba | [LearningGp](https://github.com/LearningGp) |

### Committer 成员

> 暂无

---

## 附则

- 本机制由核心维护者负责维护和修订;
- 重大修订需经核心维护者 2/3 以上成员通过;
- 本机制自公布之日起生效(目前处于试验期,之前的贡献仍会被计入)。

---

再次感谢每一位为 AgentScope-Java 做出贡献的伙伴!🎉
4 changes: 4 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -130,6 +130,10 @@ If you have ideas for new features, improvements, or find bugs that aren't alrea
- **Don't break existing APIs**: Maintain backward compatibility when possible, or clearly document breaking changes
- **Don't add unnecessary dependencies**: Keep the core library lightweight

## Community Roles & Governance 🤝

For community roles, responsibilities, and growth path (Committer / PMC evaluation, etc.), see [COMMUNITY_zh.md](./COMMUNITY_zh.md).

## Getting Help

If you need assistance or have questions:
Expand Down
4 changes: 4 additions & 0 deletions CONTRIBUTING_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,10 @@ mvn spotless:apply
- **不要破坏现有 API**:在可能的情况下保持向后兼容性,或清楚地记录破坏性更改
- **不要添加不必要的依赖项**:保持核心库轻量级

## 社区角色与共建机制 🤝

社区角色、职责与成长路径(Committer / PMC 评审标准等)详见 [COMMUNITY_zh.md](./COMMUNITY_zh.md)。

## 获取帮助

如果需要帮助或有疑问:
Expand Down
Loading