首页/开发/Git 与协作速查/Issue 分流与模板
协作与代码评审75 条

Issue 分流与模板

用 Issue 模板收集必要信息(版本、复现步骤、日志),用标签与负责人机制分流;明确「需要更多信息」的闭环,避免 Issue 长期悬空。

Git 与协作速查开发更新于 2026-10-13

Issue 分流与模板是什么

用 Issue 模板收集必要信息(版本、复现步骤、日志),用标签与负责人机制分流;对「需要更多信息」的 Issue 给出时限与闭环,避免长期悬空。它是把外部反馈转化为可执行工作的入口流程。

基本信息

模板.github/ISSUE_TEMPLATE/ 下按类型放置(缺陷/功能/文档)
分流打标签、指派负责人、标记 needs-info 与 good first issue
节流无法复现的 Issue 给出截止说明后关闭
渠道安全类问题走专用渠道而不是公开 Issue
节奏定期批量处理新 Issue,避免积压
指标响应时长、关闭率、重开率用于评估分流质量

典型使用场景

  • 新项目开放反馈:模板化收集,减少来回问答。
  • 缺陷定位:必填版本与复现步骤,缩短排查时间。
  • 社区维护:good first issue 标签引导新贡献者。
  • 安全分诊:敏感问题转私下渠道,公开区不讨论细节。
  • 质量管理:定期清理无效与重复 Issue,保持列表可用。
  • 数据复盘:按标签统计问题分布,反哺产品与测试改进。
  • SLA 公示:把响应与关闭时限写进仓库说明,管理外部预期。
  • 重复合并:把重复 Issue 关联到主问题并引导订阅。

模板示例(缺陷)

模板示例(缺陷)
**版本**:
**环境**:
**复现步骤**:
1. 
**期望结果**:
**实际结果**:
**日志/截图**:(请脱敏)

分流动作对照

状态动作时限
新进贴标签、初判类别当天
缺信息标记 needs-info 并提问7 天无响应关闭
确认缺陷指派负责人、加里程碑一周内排期
不修说明理由并关闭注明替代方案
分流不是关门:先确认问题、给出下一步,再决定接受、转设计讨论或关闭;模板字段过多会降低提交率,必填项控制在能支撑定位问题的范围。;每季度复核标签体系,合并含义重叠的标签。

易错点

  • 模板字段过多会降低提交率,必填项控制在能支撑定位问题的范围。
  • 日志里常带密钥与用户数据,模板中要明确提示脱敏,收到后也要抽查。,外部提交的压缩包也要按同样标准检查。
  • needs-info 没有时限会无限悬空,设定自动关闭规则并在关闭说明里邀请补充后重开。
  • 把安全类问题当普通缺陷公开处理会造成信息泄露,模板里放安全渠道指引。

数据来源与参考

  • GitHub Docs:Configuring issue templates
  • GitHub Docs:Triaging issues(管理议题)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌