github-bug-report-triage

GitHub のバグ報告のトリアージ

GitHub の Issue をバグ報告に限って評価します。対応可能なだけの情報が含まれているかを判断してください。不十分な場合は、不足している詳細を特定し、建設的なフィードバックを提供してください。

ワークフロー

1. Issue テンプレートを確認する

既存のテンプレートを確認します：

• .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 を使い、それに照らして Issue を評価します。

2. Issue の品質を評価する

重要な質問：

1. これはバグ報告ですか？

   • Issue が機能リクエストや質問の場合は、評価しないでください

2. 説明は明確ですか？

   • 何が壊れているのか、または正しく動作していないのか
   • 期待される動作と実際の動作
   • 影響または深刻度

3. 再現できますか？

   • 再現手順
   • または、サンドボックス／StackBlitz／CodeSandbox のリンク
   • または、最小限のコード例

妥当な判断をしてください：

• テンプレートのすべての項目を必須としないでください
• 調査に必要な最低限の情報に注目してください
• 明白なバグか、エッジケースかといった状況を考慮してください

3. 判定する

対応可能：

• 問題の説明が明確
• 再現手順、またはデバッグに十分なコンテキストがある
• 実際にバグである（機能リクエストや質問ではない）

追加情報が必要：

• 説明が曖昧（「動かない」など）
• 再現手順もコード例もない
• 期待される動作が不明確
• 重要なコンテキストが不足している（例：「クラッシュする」とあるが、エラーメッセージがない）

4. フィードバックを提供する

対応可能な場合： Issue は対応可能であることを確認します。

追加情報が必要な場合： 不足している情報を、具体的かつ建設的に示します。

例

例 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：再現性が不十分なバグ報告

**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

評価：❌ 追加情報が必要

• 実際のバグについて説明している（警告メッセージ）
• エラー出力とコードへの参照がある
• ただし、最小限の再現例がない
• コードへのリンク先がプライベートリポジトリのため、アクセスしてデバッグできない

不足している情報：

• 最小限の再現例（コード例、または動作する再現例へのリンク）