Issue 分流与模板是什么
用 Issue 模板收集必要信息(版本、复现步骤、日志),用标签与负责人机制分流;对「需要更多信息」的 Issue 给出时限与闭环,避免长期悬空。它是把外部反馈转化为可执行工作的入口流程。
基本信息
| 模板 | .github/ISSUE_TEMPLATE/ 下按类型放置(缺陷/功能/文档) |
|---|---|
| 分流 | 打标签、指派负责人、标记 needs-info 与 good first issue |
| 节流 | 无法复现的 Issue 给出截止说明后关闭 |
| 渠道 | 安全类问题走专用渠道而不是公开 Issue |
| 节奏 | 定期批量处理新 Issue,避免积压 |
| 指标 | 响应时长、关闭率、重开率用于评估分流质量 |
典型使用场景
- 新项目开放反馈:模板化收集,减少来回问答。
- 缺陷定位:必填版本与复现步骤,缩短排查时间。
- 社区维护:good first issue 标签引导新贡献者。
- 安全分诊:敏感问题转私下渠道,公开区不讨论细节。
- 质量管理:定期清理无效与重复 Issue,保持列表可用。
- 数据复盘:按标签统计问题分布,反哺产品与测试改进。
- SLA 公示:把响应与关闭时限写进仓库说明,管理外部预期。
- 重复合并:把重复 Issue 关联到主问题并引导订阅。
模板示例(缺陷)
模板示例(缺陷)
**版本**:
**环境**:
**复现步骤**:
1.
**期望结果**:
**实际结果**:
**日志/截图**:(请脱敏)分流动作对照
| 状态 | 动作 | 时限 |
|---|---|---|
| 新进 | 贴标签、初判类别 | 当天 |
| 缺信息 | 标记 needs-info 并提问 | 7 天无响应关闭 |
| 确认缺陷 | 指派负责人、加里程碑 | 一周内排期 |
| 不修 | 说明理由并关闭 | 注明替代方案 |
分流不是关门:先确认问题、给出下一步,再决定接受、转设计讨论或关闭;模板字段过多会降低提交率,必填项控制在能支撑定位问题的范围。;每季度复核标签体系,合并含义重叠的标签。