61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
---
|
|
name: gh-triage
|
|
description: Fetch all GitHub issues via gh CLI and provide consolidated AI-powered analysis with clustering, prioritization, and actionable insights. Use for issue triage, backlog cleanup, or when user mentions "issues", "triage", or "backlog".
|
|
license: MIT
|
|
metadata:
|
|
author: bmad-code-org
|
|
version: "2.1.0"
|
|
anthropic-internal: Core team issue triage tool for BMad Method repositories
|
|
min-github-cli-version: "2.0"
|
|
compatibility: Requires gh CLI, Python 3.8+, and git repository
|
|
---
|
|
|
|
# GitHub Issue Triage
|
|
|
|
**IMPORTANT:** Never include time or effort estimates in output or recommendations.
|
|
|
|
## What This Does
|
|
|
|
1. **Fetch all issues** from repository via gh CLI (configurable: open/closed/all)
|
|
2. **Extract data** into structured format (JSON + markdown tables)
|
|
3. **Generate AI analysis** with:
|
|
- Issue clustering by theme
|
|
- Priority recommendations
|
|
- Actionable insights
|
|
- Cross-repo detection
|
|
- Cleanup candidates
|
|
|
|
## Steps
|
|
|
|
```bash
|
|
# 1. Navigate to scripts directory
|
|
cd .claude/skills/gh-triage/scripts
|
|
|
|
# 2. Run the triage tool (outputs to _bmad-output/triage-reports/)
|
|
python3 gh_triage.py --state open
|
|
|
|
# 3. Review the generated report
|
|
cat _bmad-output/triage-reports/triage-*.md
|
|
```
|
|
|
|
## Command Reference
|
|
|
|
| Parameter | Description | Default |
|
|
| ---------------- | ------------------------------------------ | -------------------------------------------------- |
|
|
| `--repo` | Repository (auto-detected from git remote) | current repo |
|
|
| `--state` | Filter: `all`, `open`, `closed` | `open` |
|
|
| `--focus` | Filter by keywords in title/body | none |
|
|
| `--output`, `-o` | Save output to file | `_bmad-output/triage-reports/triage-YYYY-MM-DD.md` |
|
|
| `--json` | Output as JSON instead of markdown | false (outputs to stdout) |
|
|
| `--limit` | Max issues to fetch | 1000 |
|
|
|
|
## Output
|
|
|
|
All reports automatically save to `_bmad-output/triage-reports/` with:
|
|
- Summary statistics
|
|
- Issue clusters by theme
|
|
- Priority matrix
|
|
- Actionable recommendations
|
|
- Cross-repo issues with close commands
|
|
- Cleanup candidates (duplicates, stale, outdated)
|