a2ui-remediate-problem

name	a2ui-remediate-problem
description	Remediates a specific recommendation from an A2UI compliance report issue, or resolves any general GitHub issue, by inspecting context, implementing minimal targeted fixes, verifying tests, creating a branch, and opening a developer-signed Pull Request. Use when asked to fix or remediate an A2UI compliance audit finding, recommendation, or repository issue.

A2UI Issue & Compliance Remediation Skill

This skill guides an AI coding agent or engineer on how to remediate a specific recommendation from an A2UI compliance report or resolve any general repository issue and submit a clean, developer-signed Pull Request.

---

Workflow

Follow these steps to remediate an issue:

Step 1: Identify & Read Issue Context

1. Determine the Target Issue:

   • If the user provided an issue number or URL in their request, extract ISSUE_NUMBER.
   • If no issue was specified, ask the user (prefer using the ask_question tool): "Which GitHub issue would you like to remediate? (Please provide the issue number or URL, e.g. 2391)"

2. Retrieve Context & Determine Issue Type:

   • Run the helper script to inspect the issue:

     python3 .agents/skills/a2ui-remediate-problem/scripts/extract_recommendation.py "${ISSUE_NUMBER}" [RECOMMENDATION_INDEX] --json
     

   • Scenario A: Compliance Report with Multiple Recommendations:
     • If a recommendation index was provided (e.g. 2), the script extracts that item's details and priority.
     • If no recommendation index was specified, the script outputs all available recommendations in the issue. Ask the user (via ) which recommendation item they would like to address.