triage-issue

Investigates the codebase to identify root causes and produces a GitHub issue with a TDD fix plan.

12|Updated Dec 25, 2024
One-click install
npx skills add https://github.com/whyte25/reusables --skill triage-issue-whyte25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage-issue
Source: https://github.com/whyte25/reusables/tree/main/.agents/skills/triage-issue
Command: npx skills add https://github.com/whyte25/reusables --skill triage-issue-whyte25

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you triage a reported bug or issue by quickly locating the root cause, then converting the findings into a clear GitHub issue with a TDD-based fix plan.

Core Features & Use Cases

  • Root-cause investigation: Traces the failing code path by exploring entry points, UI/API behavior, tests, recent changes, and error handling patterns.
  • Minimal, behavior-focused fix design: Identifies the smallest change that addresses the underlying cause and specifies what needs verification.
  • TDD RED-GREEN cycles: Produces an ordered set of tests (RED) and minimal code changes (GREEN) that specify observable behavior as durable acceptance criteria.

Quick Start

Ask the assistant to triage the issue you’re seeing, and instruct it to investigate the codebase and create a GitHub issue with a TDD fix plan.

Frequently Asked Questions about triage-issue

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

FAQPage Schema
How do I investigate a codebase to find the root cause of a bug?

Bug triage investigates the codebase by tracing failing code paths, exploring entry points, API behavior, tests, and recent changes to identify the root cause and plan a fix.

How do I create a GitHub issue with a TDD fix plan for a reported bug?

You can generate a GitHub issue template with TDD-based vertical-slice fix plans, ordering tests as RED cycles and minimal code changes as GREEN cycles for durable acceptance criteria.

What is a behavior-focused vertical slice in test planning?

A behavior-focused vertical slice is the minimal code change needed to address an underlying root cause, verified by ordered tests specifying observable behavior as durable acceptance criteria.

Can I use TDD RED-GREEN cycles for codebase investigation and bug fixing?

Yes, bug triage uses TDD RED-GREEN cycles during codebase investigation to produce a minimal fix design that specifies observable behaviors and verification needs for GitHub issues.

Does bug triage work without manual code exploration to diagnose unexpected behavior?

Yes, bug triage performs hands-off code exploration to diagnose unexpected behavior, automatically identifying impacted behaviors and verification needs to output a structured issue template.