triage-meeting-prep

Triage Meeting Preparation

This skill helps prepare comprehensive summaries for the twice-weekly WinAppSDK triage meetings. It focuses on issues that actually need triage attention:

1. Needs-Triage WITHOUT area label — These need area assignment (primary focus)
2. Closed issues still labeled Needs-Triage — These need follow-up replies

Note: Open issues with both Needs-Triage AND an area-* label are excluded — they're already triaged and waiting for area team action.

Research-Backed Analysis

Every suggestion and reply is backed by research:

This ensures:

• Suggested replies are technically accurate
• Workarounds are validated against the codebase
• We reference related issues customers may have missed
• Area assignments are informed by code structure

Key Outputs: What's Changed Since Last Triage

The skill tracks four critical categories for each meeting:

All suggestions include confidence scoring in [confidence:XX] format for easy filtering.

When to Use This Skill

Primary triggers — Use this skill when:

1. Preparing for triage meetings — Generate a summary of issues needing area assignment
2. Reviewing what's changed — See the diff of issues since the last triage run
3. Drafting customer replies — Get research-backed suggested replies for closed issues
4. Tracking pending items — Identify issues that still haven't been actioned from previous meetings

Anti-patterns — Do NOT use this skill when:

• Reviewing a single specific issue (use Get-IssueDetails.ps1 for individual issues)
• General issue searching without triage context
• Non-WinAppSDK repositories

Prerequisites

• GitHub CLI (gh) installed and authenticated (gh auth login)
• Access to microsoft/WindowsAppSDK repository
• Previous triage state file for diff comparison: Generated-Files/triageMeeting/previous-state.json

Migration note: If you have an existing Generated Files/triageMeeting/... directory from earlier runs, rename Generated Files to Generated-Files before using this skill, or pass explicit input/output paths to the scripts so you keep prior diff history.

Installing GitHub CLI

# Windows
winget install GitHub.cli

# Then authenticate
gh auth login

Step-by-Step Workflow

Workflow: Generate Triage Meeting Summary

1. Load previous triage state from Generated-Files/triageMeeting/previous-state.json
2. Fetch current Needs-Triage issues using the scripts:

   # Get all issues needing triage (no area label)
   ./.github/skills/triage-meeting-prep/scripts/Get-TriageIssues.ps1 -NoAreaOnly -OutputFormat summary
   
   # Or get JSON for processing
   $issues = ./.github/skills/triage-meeting-prep/scripts/Get-TriageIssues.ps1 -NoAreaOnly | ConvertFrom-Json
   

3. Categorize issues by creation date:
   • 🆕 Created This Week — createdAt ≥ last weekly triage date
   • ⏳ Older Pending — createdAt < last weekly triage date
4. Fetch area label definitions for classification:

   ./.github/skills/triage-meeting-prep/scripts/Get-RepositoryLabels.ps1 -Filter "area-*" -OutputFormat json
   

5. For each no-area issue, analyze using Get-IssueDetails.ps1:
   • Run: ./Get-IssueDetails.ps1 -IssueNumber <number> -OutputFormat summary
   • Review the issue body, comments, and labels
   • Classify the area label by reasoning about the issue content against the area label definitions (see workflow for confidence rubric)
6. Generate summary report with links to each issue's overview.md
7. Save current state for next diff comparison

Important: Every issue without an area label gets a review. The summary links to each review file.

Available Scripts

The skill provides several PowerShell scripts for data fetching and analysis:

Get-TriageIssues.ps1

Fetches all issues with the Needs-Triage label from the repository.

# Get all Needs-Triage issues without area labels
./Get-TriageIssues.ps1 -NoAreaOnly -OutputFormat summary

# Get JSON output for programmatic processing
$issues = ./Get-TriageIssues.ps1 -NoAreaOnly | ConvertFrom-Json

Parameters:

• -Repository — Repository in 'owner/repo' format (default: microsoft/WindowsAppSDK)
• -State — Filter by state: 'open', 'closed', or 'all' (default: all)
• -NoAreaOnly — Only include issues without area-* labels
• -Limit — Maximum issues to fetch (default: 200)
• -OutputFormat — Output format: 'json', 'summary', or 'table' (default: json)

Get-IssueDetails.ps1

Performs deep analysis of a single issue including scoring and recommendations.

# Analyze a specific issue
./Get-IssueDetails.ps1 -IssueNumber 1234 -OutputFormat summary

Get-RepositoryLabels.ps1

Fetches all label definitions from the repository including names, descriptions, and colors.

# Get all labels
./Get-RepositoryLabels.ps1 -OutputFormat summary

# Get only area labels
./Get-RepositoryLabels.ps1 -Filter "area-*" -OutputFormat table

# Get labels from a different repository
./Get-RepositoryLabels.ps1 -Repository "microsoft/terminal" -OutputFormat json

Parameters:

• -Repository — Repository in 'owner/repo' format (default: microsoft/WindowsAppSDK)
• -Filter — Filter pattern for label names (supports wildcards like 'area-*')
• -Limit — Maximum labels to fetch (default: 500)
• -OutputFormat — Output format: 'json', 'summary', or 'table' (default: json)

Use cases:

• Understanding available area labels for issue categorization
• Verifying label descriptions for triage decisions
• Comparing label definitions across repositories
• Finding labels that lack descriptions

Compare-TriageState.ps1

Compares current triage state with previous state to identify changes.

Save-TriageState.ps1

Saves the current triage state for future comparisons.

Output Structure

All outputs are saved to Generated-Files/triageMeeting/<date>/:

Individual issue reviews are saved to Generated-Files/issueReview/<issue-number>/:

Key Output: The summary.md includes the Suggested Actions section extracted from each issue's overview.md, with [confidence:XX] scores.

Detailed Workflow

See workflow-triage-prep.md for the complete step-by-step process.

Issue Categories

Key distinction: "Created This Week" is based on when the issue was created (createdAt), not when it was first seen in triage runs. This ensures new issues are highlighted even if triage runs multiple times per week.

Summary.md Format

See template-summary.md for the full template structure.

Area Classification (LLM-Based)

Issues without an area-* label are classified by the agent using LLM reasoning — not keyword matching. The agent:

1. Fetches area label definitions via Get-RepositoryLabels.ps1 -Filter "area-*"
2. Reads the issue title, body, and comments from Get-IssueDetails.ps1
3. Reasons about the best area match and assigns a confidence score

Confidence scale:

See workflow-triage-prep.md for the full confidence rubric and adjusters.

Action Item Types

Troubleshooting

Related Resources

• GitHub CLI documentation — gh CLI reference
• Scripts directory — PowerShell scripts for data fetching