| name | triaging-issues |
| description | Provides issue triage workflow, priority definitions, and report format. Use when analyzing GitHub issues and PRs, assessing priority, or generating triage reports.
|
Issue Triage Guidance
Gather open issues and PRs, analyze them, and recommend next steps. Search the codebase to identify affected components — don't rely on hardcoded file mappings.
Priority Definitions
| Priority | Criteria |
|---|
| 🔴 Critical | Production broken, security issue, data loss |
| 🟠 High | Major feature broken, blocking users |
| 🟡 Medium | Feature degraded, workaround exists |
| 🟢 Low | Minor issue, cosmetic, nice-to-have |
Complexity Scale
| Size | Estimate |
|---|
| S | Hours |
| M | 1-2 days |
| L | 3-5 days |
| XL | 1+ week |
Label Taxonomy
| Prefix | Values |
|---|
area: | backend, frontend, auth, streaming, infra, docs |
type: | bug, feature, enhancement, chore, docs |
priority: | critical, high, medium, low |
Triage Report Format
Open Issues Summary
| # | Title | Priority | Type | Complexity |
|---|
Per Issue — #[number]: [title]
- Priority / Type / Complexity
- Affected Areas: checklist of areas
- Relevant Files: table with file + reason
- Suggested Labels: using taxonomy above
- Recommended Next Steps: numbered list
Open PRs Summary
| # | Title | Author | Status | Files Changed |
|---|
Per PR — #[number]: [title]
- Status: Draft | Ready for review | Changes requested | Approved
- Review Notes: concerns or things to check
gh CLI Commands for Read-Only Analysis
gh issue list --state open
gh issue list --search "keyword"
gh issue view <number>
gh pr list --state open
gh pr view <number>
gh pr diff <number>
Duplicate Detection
Before deep-diving into an issue, search for duplicates:
- Use
gh issue list --search "<keywords>" with key terms from the issue title and body.
- Check closed issues too:
gh issue list --state closed --search "<keywords>".
- If a duplicate exists, note it in the triage report with a cross-reference.
Constraints
- ❌ Read-only — do NOT modify issues or PRs
- ❌ No
gh issue edit, gh issue close, gh issue label
- ❌ No
gh pr merge, gh pr close, gh pr review --approve
- ✅ Only use read commands:
list, view, search, diff
