ai-bug-triage

Classifies and deduplicates CI test failures using deterministic fingerprinting and LLM ticket generation.

Updated Jul 4, 2026
One-click install
npx skills add https://github.com/100Thieves-team/plady-expert-skills --skill ai-bug-triage-100thieves-team
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-bug-triage
Source: https://github.com/100Thieves-team/plady-expert-skills/tree/main/.claude/skills/ai-bug-triage
Command: npx skills add https://github.com/100Thieves-team/plady-expert-skills --skill ai-bug-triage-100thieves-team

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? CI pipelines and error monitoring tools produce floods of raw failure logs where the same bug appears dozens of times with different timestamps, ports, and process IDs, making manual triage slow and duplicate-prone. This Skill separates deterministic deduplication from LLM-based classification so teams get one clean, routed ticket per real defect. ## Core Features & Use Cases - Deterministic Fingerprinting: Normalizes CI logs (stripping timestamps, UUIDs, ports, PIDs), extracts stable anchors like exception type and stack frames, and hashes them into stable 16-character fingerprints for exact deduplication. - Near-Duplicate Clustering: Scores similarity across exception type, message, stack frames, component, and test name with weighted thresholds to group related failures for human merge review. - LLM Classification and Ticket Generation: Classifies failures into app bug, test bug, environment issue, flaky test, or build failure, assigns severity via a severity/priority matrix, and drafts tracker-ready tickets with repro steps and suggested assignees. - Use Case: A QA engineer facing 200 failed CI runs after a release feeds the logs through the pipeline, collapses them into 12 unique fingerprints, and gets routed Jira tickets with severity, component, and root-cause hypotheses pending human approval. ## Quick Start Ask the agent to triage the failures in your latest CI run log, classify each unique failure by severity and component, and draft deduplicated bug tickets for review.

Frequently Asked Questions about ai-bug-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically triage CI test failures?

Normalize the raw CI logs to strip timestamps, ports, and process IDs, then hash stable anchors like exception type and stack frames into fingerprints for deduplication. An LLM then classifies each unique failure by category, severity, and component, and drafts a ticket for human approval.

How do I deduplicate bug reports from CI logs?

Use deterministic fingerprinting rather than LLM comparison: normalize logs, extract stable anchors (exception type, message template, top stack frames, test name), and SHA-256 hash the canonical form. Identical failures produce identical fingerprints, and similarity scoring above 0.75 flags near-duplicates for merge review.

Should I use an LLM for bug deduplication?

No. LLMs are non-deterministic, so the same pair of errors can receive different similarity scores on repeated runs. Use deterministic fingerprinting for deduplication and reserve the LLM for severity classification, root-cause hypotheses, and human-readable ticket writing.

Does automated bug triage work with Jira and GitHub Issues?

Yes. The pipeline output is tracker-agnostic, producing title, description, labels, severity, and component fields that map to Jira, Linear, GitHub Issues, or Azure DevOps. The fingerprint is attached as a label so future runs can match against existing tickets.

Why does my bug fingerprint change between CI runs?

Fingerprints become unstable when raw logs are hashed without normalization, because timestamps, PIDs, ports, and request IDs differ every run. Apply the normalization rules first, then hash only stable anchors; the five stability assertions in the verification step confirm the fingerprinter works.

When should I buy a triage platform instead of building one?

Hosted tools like Trunk Flaky Tests, CloudBees Smart Tests, and Datadog Test Optimization already cover fingerprinting, clustering, and severity routing. Build the in-house pipeline only when you need on-prem deployment, exotic tracker integration, or an explicit AI-prompt audit trail.