feat(skills): introduce a2ui-remediate-problem skill and embed copyable prompts in compliance reports

.agents/skills/a2ui-audit/SKILL.md

@@ -33,8 +33,6 @@ fix issues.
 4. **Summarize the report**:
    - Add a `## Summary` section at the top of the `compliance_report.md` file with a detailed overview of the audit scope and key findings across all audited codebases.
    - Add a `## Recommendations` section listing actionable, prioritized follow-up items formatted as a numbered list (e.g. `1. **P0**: ...`). Each numbered item MUST represent a concrete, self-contained remediation task.
-   - Immediately below the recommendations list, include the mandatory automated remediation callout:
-     > 🤖 **Automated Remediation**: Comment `/fix <number>` (e.g., `/fix 1`) on this issue to have an agent create a draft PR for that recommendation.
 
 5. **Format and Detail Requirements**:
    - **MANDATORY COMPLETE REPOSITORY COVERAGE**: The report MUST include status rows and detailed findings for **ALL 8 production codebases** discovered by `check_compliance.py`. Do NOT truncate, shortcut, or abbreviate the summary tables or detailed findings.
@@ -49,6 +47,7 @@ fix issues.
      ```bash
      python3 .agents/skills/a2ui-audit/scripts/create_compliance_report.py compliance_report.md --repo a2ui-project/a2ui
      ```
+   - The publishing script will create the GitHub issue, automatically inject copyable remediation prompt blocks referencing the newly created issue URL under each recommendation item, and update the issue body.
    - Ensure the helper script runs successfully.
    - Clean up the temporary file `compliance_report.md` after completion.
 
@@ -65,10 +64,11 @@ When compiling `compliance_report.md`, use the following structure:
 
 ## Recommendations
 
-1. **[Priority]**: [Clear title and detailed explanation of the fix needed, specifying affected directories or modules.]
-2. **[Priority]**: [Clear title and detailed explanation of the fix needed, specifying affected directories or modules.]
+1. **[Priority]**: **[Title]**
+   - [Clear detailed explanation of the fix needed, specifying affected directories or modules.]
 
-> 🤖 **Automated Remediation**: Comment `/fix <number>` (e.g., `/fix 1`) on this issue to have an agent create a draft PR for that recommendation.
+2. **[Priority]**: **[Title]**
+   - [Clear detailed explanation of the fix needed, specifying affected directories or modules.]
 
 ## Codebase Blueprint Compliance Audit
 

.agents/skills/a2ui-audit/scripts/create_compliance_report.py

@@ -17,21 +17,107 @@
 
 This script parses command-line arguments to locate the compiled markdown report
 and post it as a new GitHub issue in the target repository using the `gh` CLI.
+It then automatically injects copyable remediation prompt blocks with the newly
+created issue URL under each recommendation item and updates the issue body.
 """
 
+from __future__ import annotations
+
 import argparse
 import datetime
 import os
+import re
 import subprocess
 import sys
 
 
+def inject_recommendation_prompts(report_content: str, issue_url: str) -> str:
+    """Injects copyable agent prompt blocks under each recommendation item."""
+    lines = report_content.splitlines()
+    new_lines: list[str] = []
+    in_recommendations = False
+    rec_pattern = re.compile(r"^(\d+)\.\s+(.*)")
+
+    i = 0
+    while i < len(lines):
+        line = lines[i]
+        stripped = line.strip()
+        if stripped.startswith("## Recommendations"):
+            in_recommendations = True
+            new_lines.append(line)
+            i += 1
+            continue
+        elif in_recommendations and (stripped.startswith("## ") or stripped == "---"):
+            if stripped.startswith("## "):
+                in_recommendations = False
+            new_lines.append(line)
+            i += 1
+            continue
+
+        if in_recommendations:
+            match = rec_pattern.match(stripped)
+            if match:
+                idx = int(match.group(1))
+                new_lines.append(line)
+                i += 1
+
+                # Collect subsequent lines belonging to this recommendation
+                rec_lines: list[str] = []
+                while i < len(lines):
+                    next_stripped = lines[i].strip()
+                    if (
+                        rec_pattern.match(next_stripped)
+                        or next_stripped.startswith("## ")
+                        or next_stripped == "---"
+                    ):
+                        break
+                    # If an existing prompt block or label is found, skip it
+                    if next_stripped.startswith("Copy this prompt"):
+                        i += 1
+                        continue
+                    if next_stripped.startswith("````") or next_stripped.startswith(
+                        "```"
+                    ):
+                        fence = (
+                            next_stripped[:4]
+                            if next_stripped.startswith("````")
+                            else next_stripped[:3]
+                        )
+                        i += 1
+                        while i < len(lines) and not lines[i].strip().startswith(fence):
+                            i += 1
+                        if i < len(lines):
+                            i += 1
+                        continue
+                    rec_lines.append(lines[i])
+                    i += 1
+
+                while rec_lines and rec_lines[-1].strip() == "":
+                    rec_lines.pop()
+
+                new_lines.extend(rec_lines)
+
+                prompt_block = f"""   Copy this prompt to implement this recommendation:
+   ````markdown
+   Read the A2UI issue at {issue_url} and use the `a2ui-remediate-problem` skill to implement recommendation {idx} described in the issue's Recommendation section.
+   ````"""
+                new_lines.append(prompt_block)
+                new_lines.append("")
+                continue
+
+        new_lines.append(line)
+        i += 1
+
+    return "\n".join(new_lines).rstrip() + "\n"
+
+
 def main() -> None:
     """Parses arguments and creates a GitHub issue with the compliance report.
 
     Validates that the input report exists, formats the issue title, and invokes
     the GitHub CLI (`gh`) to file the issue under the target repository with
-    the required labels.
+    the required labels. Then injects copyable prompt blocks with the generated
+    issue URL and updates the issue body.
     """
     parser = argparse.ArgumentParser(
         description="Post blueprint compliance report as a GitHub issue."
@@ -47,6 +133,9 @@ def main() -> None:
         print(f"Error: Report file not found at '{report_path}'")
         sys.exit(1)
 
+    with open(report_path, "r", encoding="utf-8") as f:
+        original_content = f.read()
+
     today = datetime.date.today().isoformat()
     issue_title = f"Weekly A2UI Compliance Report ({today})"
 
@@ -87,8 +176,38 @@ def main() -> None:
         print(result.stderr)
         sys.exit(1)
 
+    issue_url = result.stdout.strip()
     print("Success: Compliance report issue posted successfully.")
-    print(result.stdout.strip())
+    print(issue_url)
+
+    # Post-process report to inject recommendation prompt blocks and update issue
+    enhanced_content = inject_recommendation_prompts(original_content, issue_url)
+    if enhanced_content != original_content:
+        with open(report_path, "w", encoding="utf-8") as f:
+            f.write(enhanced_content)
+
+        issue_id = issue_url.rstrip("/").split("/")[-1]
+        edit_cmd = [
+            "gh",
+            "issue",
+            "edit",
+            issue_id,
+            "--body-file",
+            report_path,
+        ]
+        if args.repo:
+            edit_cmd.extend(["--repo", args.repo])
+
+        print(f"Updating issue with remediation prompt blocks: {' '.join(edit_cmd)}")
+        edit_result = subprocess.run(
+            edit_cmd, capture_output=True, text=True, check=False, env=env
+        )
+        if edit_result.returncode != 0:
+            print(
+                "Warning: Failed to update issue description with prompt blocks:"
+                f" {edit_result.stderr}",
+                file=sys.stderr,
+            )
 
 
 if __name__ == "__main__":