Ai Bug Fix Triage

Bug Triage

Triage JIRA bugs from a project backlog against a loaded repository to determine which bugs an AI agent can fix. Produces a focused fixability report.

Scope

This skill answers one question: can an AI agent fix this bug in this repo? It classifies issues as AI-Fixable, Needs Human, or Needs Info based on a fixability rubric.

"Bug" is used broadly here — analyze Bugs and Stories for fixability. Skip Epics, Initiatives, and Features as they are too high-level for a single code fix (note them as skipped in the report).

Out of scope:

• Deduplicate bugs — does not detect or merge duplicate tickets
• Prioritize or re-rank severity — respects the existing JIRA priority as-is
• Estimate effort — no story points, t-shirt sizes, or time estimates

Prerequisites

• Atlassian MCP configured and authenticated (provides getAccessibleAtlassianResources, searchJiraIssuesUsingJql, getJiraIssue, editJiraIssue, addCommentToJiraIssue)
• Target repository loaded in the workspace — the user will have it open or will specify it
• AGENTS.md or CLAUDE.md present in the repo (used to understand repo structure, test commands, and conventions)

Usage

User: Triage  bugs against this repo
User: Triage bugs from filter=
User: Triage project =  AND component = "" AND status = New
User: Triage filter= and update JIRA with labels
User: Triage just 

Implementation

Step 1: Determine the Query, Target Repo, and Scope

Query:

1. If the user provides a JQL query, use it directly
2. If the user provides a filter ID, use filter= as the JQL
3. If the user names a component or project, construct JQL defaulting to untriaged, unassigned bugs and stories:

project = AND component = "" AND type in (Bug, Story) AND status in (New, Refinement, "To Do") AND assignee is EMPTY ORDER BY priority DESC

1. If nothing specific is given, ask: "What JQL query or JIRA filter should I use?"

Target repo:

1. If the user names a repo, use it
2. If the workspace has a repo loaded, confirm: "I see `` loaded — should I triage bugs against this repo?"
3. If ambiguous, ask which repo to analyze against

Repo state (read-only by default):

Triage is read-only — never switch branches or modify files. Run git fetch origin and compare HEAD with origin/main. If behind, inform the user but proceed on the current HEAD. Only create a temporary branch (git checkout -b ai-bug-fix-triage- origin/main) if the user explicitly asks. State which commit is being used.

Steps 2-6: Detailed Implementation

See references/guidelines.md for detailed criteria covering:

• Step 2: Fetching bugs via Atlassian MCP, batch progress tracking, and fast-path vs. interactive-path logic
• Step 3: Filtering irrelevant tickets using label hints, idempotency checks, and exclusion criteria
• Step 4: Analyzing each bug for AI fixability (relevance check, code search, fixability rubric, classification)
• Step 5: Generating the triage report (header, summary table, AI-Fixable bugs table, detailed analysis)
• Step 6: Optional JIRA writeback (labels and triage comments with idempotency)

Classifications at a glance:

| Classification | Criteria | Label | |---------------|----------|-------| | AI-Fixable | Root cause identifiable, clear code fix, fix verifiable | ai-fixable | | Needs Human | Any criterion fails | ai-nonfixable | | Needs Info | Description too vague to determine root cause | ai-needs-info |

Error Handling

• MCP not available: Tell the user to configure and authenticate the Atlassian MCP server
• Empty results: Report no bugs found, suggest broadening the JQL
• Repo not loaded: Ask the user to open the target repo first
• Permission denied on writeback: Skip that ticket, continue with the rest
• Rate limiting: Process writeback calls sequentially; back off on 429 responses

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: opendatahub-io
• Source: opendatahub-io/ai-helpers
• License: Apache-2.0
• Homepage: https://opendatahub-io.github.io/ai-helpers/

Install and usage instructions live in the source repository linked above.