Windows App SDK Issue Triage Report

Issue Triage Report Generator

This skill generates comprehensive GitHub Feature Area Status reports that help engineering teams identify high-priority issues, track triage status, and highlight items needing immediate attention.

When to Use This Skill

Primary triggers — Generate a report when:

1. Engineering triage meetings — Create status reports showing open issues, needs-triage counts, and highlighted issues per feature area.

2. Priority analysis requests — Identify which issues should get engineering focus based on deterministic scoring (reactions, age, comments) plus agent content assessment.

3. Feature area health checks — Assess the health of specific areas by analyzing issue distribution, triage backlog, and proposal counts.

4. Dashboard generation — Produce markdown tables or formatted reports for team communication channels.

Anti-patterns — Do NOT use this skill when:

• Looking for a specific issue by number (use GitHub search directly)
• Creating or editing issues (use GitHub MCP tools)
• Analyzing code changes or PRs (use PR management tools)

Prerequisites

• GitHub CLI (gh) installed and authenticated
• PowerShell 5.1+ (Windows) or PowerShell Core (cross-platform)
• Access to the target GitHub repository (microsoft/WindowsAppSDK)
• Area contacts configuration (see below)

Setting Up Area Contacts

The area contacts file maps feature areas to team members. This file is required for contact lookups and is stored in your local .user/ folder (not committed to the repository).

1. Create the directory structure:

   mkdir -p .user/issue-triage-report

2. Copy the template and customize:

   cp .github/skills/issue-triage-report/references/area-contacts.json .user/issue-triage-report/area-contacts.json

3. Edit .user/issue-triage-report/area-contacts.json with your team's actual contacts

Note: The .user/ folder is gitignored, so your team contacts remain private.

Available Scripts

Generate-FeatureAreaReport.ps1

Generate the full feature area status report with highlight scoring.

Location: ./scripts/Generate-FeatureAreaReport.ps1

./scripts/Generate-FeatureAreaReport.ps1 [-Repo <owner/repo>] [-OutputFormat <markdown|csv|json>] [-HighlightCount <n>]

Example:

./scripts/Generate-FeatureAreaReport.ps1 -OutputFormat markdown -HighlightCount 3

Get-HighlightScore.ps1

Calculate the highlight score for a specific issue to determine priority.

Location: ./scripts/Get-HighlightScore.ps1

./scripts/Get-HighlightScore.ps1 -IssueNumber <number> [-Repo <owner/repo>] [-Verbose]

Example:

./scripts/Get-HighlightScore.ps1 -IssueNumber 4651 -Verbose

Get-AreaContacts.ps1

Retrieve or update the area-to-contact mapping configuration.

Location: ./scripts/Get-AreaContacts.ps1

./scripts/Get-AreaContacts.ps1 [-Area <area-name>] [-Update]

Step-by-Step Workflows

Workflow 1: Generate Weekly Triage Report

1. Ensure GitHub CLI is authenticated:

   gh auth status

2. Generate the report:

   ./scripts/Generate-FeatureAreaReport.ps1 -OutputFormat markdown -HighlightCount 3

Before running the command above, have the agent save runtime assessments to:

• ./references/AgentAssessments.json

This file is loaded automatically at script start and applied as per-run overrides. Every assessed issue entry must include agent reasoning in the reasoning field.

Required per-issue schema in assessments:

• severityTier: critical|high|medium|low|none
• isBlocker: true|false
• reasoning: short rationale explaining severity/blocker judgment

Example:

{
   "assessments": {
      "2894": {
         "severityTier": "high",
         "isBlocker": false,
         "reasoning": "Frequent user impact in notifications flow; clear repro in comments; no confirmed workaround."
      }
   }
}

3. Run an agent content review for each highlighted issue using title, body, labels, and comments.

4. Add annotation tags in report narrative: [severity:critical|high|medium|low|none], [blocker:yes|no], and optional [confidence:XX].

5. Copy output to team communication channel (Teams, email, wiki)

Workflow 2: Analyze a Specific Feature Area

1. Get area-specific issues:

   gh issue list --repo microsoft/WindowsAppSDK --label "area-Notifications" --state open --json number,title,body,labels,reactionGroups,createdAt,comments

2. Check individual issue scores:

   ./scripts/Get-HighlightScore.ps1 -IssueNumber 2894 -Verbose

3. Review scoring factors and prioritize accordingly

Workflow 3: Update Area Contacts

1. View current contacts:

   ./scripts/Get-AreaContacts.ps1

2. Update specific area contact:

   ./scripts/Get-AreaContacts.ps1 -Area "area-Notifications" -Update

Highlight Scoring Algorithm

Issues are scored with a normalized composite on a 0..100 scale. See scoring-algorithm.md for complete details.

PowerShell computes deterministic score factors and highlight labels. Severity and blocker are assessment-driven inputs.

Scripts load baseline assessments from:

• ./references/IssueAssessments.json

They also load runtime agent assessments from:

• ./references/AgentAssessments.json

If both files include the same issue number, IssueAssessments.json takes precedence.

If either file is missing or malformed, scripts emit status/warning output and continue with fallback behavior.

Implementation note: scripts load these files through a single Read-Assessments function in ./scripts/ReportLib.ps1 using -AssessmentType Issue or -AssessmentType Agent.