fix-issues

Fix Issues Skill

Automated workflow: GitHub bug issues → analyze → fix → PR.

Announce at start: "I'm using fix-issues skill to find and fix a GitHub bug issue."

Operating Modes

Batch Mode (default)

Invocation: /fix-issues

• Fetches open bug issues, finds the best candidate, fixes it
• Runs full Phase 1 → Phase 2 → Phase 3
• Fixes 1 issue per invocation

Daemon Mode

Invocation: /fix-issues limit=1 (from daemon script)

• Phase 1 uses priority descent: high-signal issues first, then progressively lower
• Fixes only 1 issue (controlled by limit parameter), then exits
• If no fixable issue exists → outputs [NO_FIXABLE_ISSUES] and exits

Prerequisites

• gh CLI must be authenticated
• Working directory will be auto-cleaned (stash + checkout main) at startup

Workflow

Phase 1: Collect & Filter Issues

Step 1.1: Verify Environment

git status --porcelain
git branch --show-current

If working directory has staged or modified tracked files, stash them and proceed:

git stash -m "fix-issues: auto-stash before starting"

Do NOT use --include-untracked — untracked files (like skill files not yet merged to main) must remain in the working directory.

Then switch to main:

git checkout main
git pull origin main

Step 1.1b: Load Skip List (Daemon Mode Only)

In daemon mode (limit > 0), load the skip list to avoid re-analyzing issues that were already triaged in previous sessions. The skip list is stored at:

~/.aionui-fix-issues/skip-list.json

Format:

{
  "1782": { "reason": "already_fixed", "summary": "PR #1800 merged" },
  "1707": { "reason": "environment_issue", "summary": "Kaspersky antivirus blocking" },
  "1697": {
    "reason": "needs_more_info",
    "summary": "Missing reproduction steps",
    "commented_at": "2026-03-27T12:00:00Z"
  },
  "1774": {
    "reason": "fix_failed",
    "summary": "Type check failed after 3 attempts",
    "commented_at": "2026-03-27T14:00:00Z"
  }
}