用途:为设计系统建立或记录结构化的贡献流程,覆盖从提案到发布的完整旅程,产出团队可跟随的流程文档,包含明确阶段、决策标准与各关卡负责人。
主要能力:
- 按现有状态与维护能力选择三种形态:轻量(三阶段:提案→构建→发布)、标准(六阶段,社区评审对新组件外简化为发布说明预览)、完整(六阶段全深度,含版本与消费者检查)。
- 先定义贡献类型再定阶段:A 缺陷修复或小增强走轻量路径;B 组件增强走标准路径;C 新组件走完整路径;D 系统级变更走完整路径并延长社区评审。
- 六阶段:提案、设计、构建、文档、社区评审、发布。每阶段有产出物与签署条件,如提案含模板与五项标准检查(复现性、通用性、可访问性、归属、契合度)。
- 明确拒绝记录、延期提案的复评机制,以及系统不接收的内容(单团队专用、重复功能、无法无障碍实现、贡献者不愿文档化的工作)。
使用方式:先确认是否已有贡献流程、谁负责维护、常见贡献类型与评审容量,再据此选形态;读取 CONTRIBUTING.md、PR 模板与 .github/ISSUE_TEMPLATE/ 后更新而非重写。需把提案模板落到实际提交处(如 GitHub issue 表单或文档平台模板)。若无人负责系统则先解决归属,不再编写。
限制:文档强调能力与形态匹配,SLA 占位符须在使用前填写;未提供具体工具、价格或平台信息;若开头的引用校验发现安装不完整,应停止并按安装说明重装、运行 verify-install.sh,除非用户明确要求继续并说明未使用参考材料。