BMAD-METHOD/.claude/skills/gh-triage/prompts/instructions.md

2.4 KiB

GitHub Issue Triage with AI Analysis

CRITICAL RULES:

  • NEVER include time or effort estimates in output or recommendations
  • Focus on WHAT needs to be done, not HOW LONG it takes
  • Use Bash tool with gh CLI for all GitHub operations

Execution

Step 1: Fetch Issues

Use gh issue list --json number,title,body,labels to fetch all open issues.

Step 2: Batch Creation

Split issues into batches of ~10 issues each for parallel analysis.

Step 3: Parallel Agent Analysis

For EACH batch, use the Task tool with subagent_type=general-purpose to launch an agent with prompt from prompts/agent-prompt.md

Step 4: Consolidate & Generate Report

After all agents complete, create a comprehensive markdown report saved to _bmad-output/triage-reports/triage-YYYY-MM-DD.md

Report Format

Executive Summary

  • Total issues analyzed
  • Issue count by priority (CRITICAL, HIGH, MEDIUM, LOW)
  • Major themes discovered
  • Top 5 critical issues requiring immediate attention

Critical Issues (CRITICAL Priority)

For each CRITICAL issue:

  • #123 - Issue Title
  • What it's about: [Deep understanding]
  • Affected: [Components]
  • Why Critical: [Rationale]
  • Suggested Action: [Specific action]

High Priority Issues (HIGH Priority)

Same format as Critical, grouped by theme.

Theme Clusters

For each major theme:

  • Theme Name (N issues)
  • What connects these: [Pattern]
  • Root cause: [If identifiable]
  • Consolidated actions: [Bulk actions if applicable]
  • Issues: #123, #456, #789

Relationships & Dependencies

  • Duplicates: List pairs with gh issue close commands
  • Related Issues: Groups of related issues
  • Dependencies: Blocking relationships

Cross-Repo Issues

Issues that should be migrated to other repositories.

For each, provide:

gh issue close XXX --repo CURRENT_REPO --comment "This issue belongs in REPO. Please report at https://github.com/TARGET_REPO/issues/new"

Cleanup Candidates

  • v4-related: Deprecated version issues with close commands
  • Stale: No activity >30 days
  • Low priority + old: Low priority issues >60 days old

Actionable Next Steps

Specific, prioritized actions:

  1. [CRITICAL] Fix broken installer - affects all new users
  2. [HIGH] Resolve Windows path escaping issues
  3. [HIGH] Address workflow integration bugs etc.

Include gh commands where applicable for bulk actions.