问题工作流指南¶

本文档定义了 vLLM Ascend 项目中 问题 的标准生命周期——从创建到分诊、主动处理，再到最终关闭。它建立了统一的标签使用、负责人分配和沟通预期，以确保贡献者与维护者之间的顺畅协作。

1. 标签类别¶

1.1 状态标签¶

这些标签用于跟踪问题在工作流中的当前状态。

1.2 类型标签¶

这些标签用于描述问题的性质。

1.3 优先级标签（可选）¶

1.4 贡献标签（可选）¶

2. 工作流¶

阶段 1 — 首次响应¶

当问题首次由值班维护者接手时：

• 应用 triaged 以表示该问题可以分类，并添加相关模块标签，以便将问题路由到相应的模块维护者进行详细分诊。
• 应用 triage review 以表示该问题在分类前需要更多审查和具体分析。

阶段 2 — 分诊和分析¶

在对问题内容进行全面审查后：

• 核实并应用适当的 问题类型 标签（bug、feature request、RFC、question、documentation、installation、performance、new model 等）。
• 处理终止状态：
  • 对于重复项，应用 duplicated 标签，提供说明以及现有问题或 PR 的链接。如果没有其他问题，关闭该问题。
  • 对于无效报告，提供说明，应用 invalid 和 resolved 标签，并关闭该问题。如果问题创建者有其他问题，可以评论或请求重新打开。
• 可选地应用 优先级 标签（high、medium 或 low）。
• 如果欢迎社区贡献，应用 help wanted。对于范围明确且适合初学者的任务，也应用 good first issue。
• 分配问题负责人，并用 triaged 替换 triage review，以表示分诊已完成。

阶段 3 — 关闭¶

分诊后，问题进入跟踪和实现阶段：

• 保持问题处于进行中状态，直到通过已合并的 PR 或其他已确认的解决路径解决。
• 问题一旦解决，应用 resolved 并关闭，最好附上已合并 PR 的引用或对解决方案的简短说明。
• 如果问题长时间保持不活跃，在自动关闭前应用 stale 作为最终状态。