github-bug-report-triage

GitHub Bug Report 分类

仅评估 GitHub 问题中的 Bug 报告。判断信息是否充分，足以采取行动。如果不充分，请指出缺少的详情并提供有建设性的反馈。

工作流

1. 查找问题模板

检查是否有现成模板：

• .github/ISSUE_TEMPLATE/bug_report.md
• .github/ISSUE_TEMPLATE/bug_report.yml
• .github/ISSUE_TEMPLATE/*.md
• .github/ISSUE_TEMPLATE.md
• ISSUE_TEMPLATE.md

如果没有模板，则使用此技能中的 references/ISSUE_TEMPLATE.md 作为备用模板，然后根据该模板评估问题。

2. 评估问题质量

关键问题：

1. 这是 Bug 报告吗？

   • 如果问题是功能请求或提问，请勿评估

2. 描述是否清楚？

   • 哪些内容出错或异常
   • 预期行为与实际行为的差异
   • 影响或严重程度

3. 能否复现？

   • 逐步复现说明
   • 或 sandbox/StackBlitz/CodeSandbox 链接
   • 或最小代码示例

合理判断：

• 不要要求填写模板中的所有字段
• 聚焦于调查问题所需的最少信息
• 考虑具体情况（明显的 Bug 与边缘情况）

3. 作出判断

信息足以采取行动：

• 清楚描述问题
• 包含复现路径，或提供足够的调试上下文
• 确实是 Bug（而非功能请求或提问）

需要更多信息：

• 描述含糊（“不能用”）
• 缺少复现步骤，且没有代码示例
• 预期行为不明确
• 缺少关键上下文（例如只说“崩溃了”，但没有错误消息）

4. 提供反馈

如果信息充分： 确认该问题足以采取行动。

如果需要更多信息： 具体指出缺少的内容。反馈应有建设性且明确。

示例

示例 1：可以开始调查

**Issue**: Dropdown menu doesn't close on mobile Safari

**Description**: 
When clicking a dropdown menu item on iOS Safari, the menu stays 
open instead of closing. Works fine on desktop Chrome/Firefox.

**Steps**:
1. Visit https://stackblitz.com/edit/my-repro
2. Open on iOS Safari
3. Click dropdown, select any item
4. Menu stays open (should close)

**Environment**: iOS 16.3, Safari

评估：✅ 信息充分

• 描述清楚
• 提供了复现链接
• 环境详情具体

示例 2：需要更多信息

**Issue**: Button is broken

**Description**: 
The submit button doesn't work properly.

评估：❌ 需要更多信息 缺少的信息：

• “不能用”具体指什么？（无法点击？报错？行为异常？）
• 预期行为与实际行为的差异
• 复现步骤
• 是否有错误消息

示例 3：边缘情况——合理

**Issue**: Console error on form submit

**Description**:
Getting "Cannot read property 'value' of null" when submitting 
the contact form. Happens 100% of the time.

**Error**:

TypeError: Cannot read property 'value' of null at handleSubmit (ContactForm.tsx:45)

**Environment**: Chrome 120, Windows 11

评估：✅ 信息充分

• 错误消息和堆栈跟踪清楚
• 文件和行号具体
• 可复现（每次都会发生）
• 注意：没有明确的复现步骤，但错误信息足够清楚，可以开始调查

示例 4：复现信息不足的 Bug 报告

**Issue**: [glob-loader] Duplicate id warning on file update

**Description**:
I'm encountering an issue with the glob loader. Whenever I update 
the watched file, I get a warning message in the logs.


The warning message:

13:23:31 [WARN] [glob-loader] Duplicate id "russian-test" found in /Users/user/Code/project/content/posts/russian-test.md. Later items with the same id will overwrite earlier ones.

**Expected**: No warning message

**Link to Minimal Reproducible Example**: - N/A

评估：❌ 需要更多信息

• 描述了一个真实的 Bug（警告消息）
• 包含错误输出和代码引用
• 但是：没有提供最小复现
• 代码链接指向私有仓库（无法访问以进行调试）

缺少的信息：

• 最小复现（示例代码或可运行复现的链接）