Back to Details

github-bug-report-triage

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

GitHub Bug Report Triage

GitHub漏洞报告分类

Evaluate GitHub issues for bug reports only. Determine if they contain sufficient info to be actionable. If not, identify missing details and provide constructive feedback.
仅针对漏洞报告评估GitHub问题。判断它们是否包含足够的可操作信息。如果没有，识别缺失的细节并提供建设性反馈。

Workflow

工作流程

1. Locate Issue Template

1. 查找问题模板

Check for existing templates:
  • .github/ISSUE_TEMPLATE/bug_report.md
  • .github/ISSUE_TEMPLATE/bug_report.yml
  • .github/ISSUE_TEMPLATE/*.md
  • .github/ISSUE_TEMPLATE.md
  • ISSUE_TEMPLATE.md
If no template exists, use 
references/ISSUE_TEMPLATE.md
from this skill as the fallback template, then evaluate the issue against it.
检查现有模板：
  • .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. Evaluate Issue Quality

2. 评估问题质量

Critical questions:
  1. Is this a bug report?
    • If the issue is a feature request or a question, do not evaluate this issue
  2. Is the description clear?
    • What's broken or wrong
    • Expected behavior vs. what actually happens
    • Impact or severity
  3. Can we reproduce it?
    • Step-by-step reproduction
    • OR sandbox/StackBlitz/CodeSandbox link
    • OR minimal code example
Be reasonable:
  • Don't require every template field to be filled
  • Focus on minimum info needed to investigate
  • Consider context (obvious bugs vs. edge cases)
关键问题：
  1. 这是漏洞报告吗？
    • 如果该问题是功能请求或疑问，请勿评估此问题
  2. 描述是否清晰？
    • 哪里出现故障或问题
    • 预期行为与实际发生的情况
    • 影响或严重程度
  3. 我们能否复现该问题？
    • 分步复现步骤
    • 或sandbox/StackBlitz/CodeSandbox链接
    • 或最小代码示例
保持合理性：
  • 不要求填写所有模板字段
  • 专注于调查所需的最低信息
  • 考虑上下文（明显漏洞与边缘情况）

3. Make Determination

3. 做出判断

Ready to be actionable:
  • Has clear problem description
  • Includes reproduction path OR enough context to debug
  • Actually a bug (not feature/question)
Needs more info:
  • Vague description ("it doesn't work")
  • Missing reproduction steps AND no code example
  • Unclear what the expected behavior should be
  • Missing critical context (e.g., "crashes" but no error message)
可立即处理：
  • 有清晰的问题描述
  • 包含复现路径或足够的调试上下文
  • 确实是漏洞（而非功能请求/疑问）
需要更多信息：
  • 描述模糊（如“无法工作”）
  • 缺少复现步骤且无代码示例
  • 预期行为不明确
  • 缺少关键上下文（如“崩溃”但无错误信息）

4. Provide Feedback

4. 提供反馈

If ready: Confirm issue is actionable.
If needs info: Specify what's missing. Be constructive and specific.
如果可处理： 确认问题可操作。
如果需要更多信息： 明确指出缺失的内容。保持建设性和具体性。

Examples

示例

Example 1: Ready to Investigate

示例1：可立即调查

markdown
**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
Evaluation: ✅ Ready
  • Clear description
  • Has reproduction link
  • Specific environment details
markdown
**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
评估：✅ 可处理
  • 描述清晰
  • 提供了复现链接
  • 包含具体的环境细节

Example 2: Needs More Info

示例2：需要更多信息

markdown
**Issue**: Button is broken

**Description**: 
The submit button doesn't work properly.
Evaluation: ❌ Needs info Missing:
  • What does "doesn't work" mean? (no click? error? wrong behavior?)
  • Expected vs. actual behavior
  • Steps to reproduce
  • Any error messages
markdown
**Issue**: Button is broken

**Description**: 
The submit button doesn't work properly.
评估：❌ 需要更多信息 缺失内容：
  • “无法工作”具体指什么？（无法点击？报错？行为异常？）
  • 预期行为与实际行为对比
  • 复现步骤
  • 任何错误信息

Example 3: Edge Case - Reasonable

示例3：边缘情况 - 合理场景

markdown
**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
Evaluation: ✅ Ready
  • Clear error message with stack trace
  • Specific file/line reference
  • Reproducible (100% of time)
  • Note: No explicit repro steps, but error is clear enough to investigate
markdown
**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
评估：✅ 可处理
  • 包含清晰的错误信息和堆栈跟踪
  • 有具体的文件/行号引用
  • 可复现（100%出现）
  • 注意：没有明确的复现步骤，但错误信息足够清晰以进行调查

Example 4: Bug Report with Insufficient Reproducibility

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

markdown
**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
Evaluation: ❌ Needs info
  • Describes a real bug (warning message)
  • Has error output and code reference
  • BUT: No minimal reproduction provided
  • Code link points to private repo (can't access to debug)
Missing:
  • Minimal reproduction (example code or link to a working reproduction)
markdown
**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
评估：❌ 需要更多信息
  • 描述了真实的漏洞（警告信息）
  • 包含错误输出和代码引用
  • 但：未提供最小复现示例
  • 代码链接指向私有仓库（无法访问以调试）
缺失内容：
  • 最小复现示例（示例代码或可运行的复现链接）