---
id: daily-triage-issue
name: "triage-issue"
url: https://skills.yangsir.net/skill/daily-triage-issue
author: mattpocock
domain: testing
tags: ["root-cause-analysis", "github-issue", "tdd", "automated-triage"]
install_count: 6300
rating: 4.40 (77 reviews)
github: https://github.com/mattpocock/skills
---

# triage-issue

> 自动调查问题报告、定位根因并创建包含TDD修复计划的GitHub Issue，几乎无需人工干预

**Stats**: 6,300 installs · 4.4/5 (77 reviews)

## Before / After 对比

### 问题调查与Issue创建

**Before**:

收到问题报告后需要手动复现、阅读日志、排查代码定位根因，然后撰写详细Issue描述和修复方案，整个过程耗时数小时

**After**:

自动调查问题报告并深入代码定位根因，生成包含TDD修复计划的结构化GitHub Issue，开发者只需审核确认即可开始修复工作

| Metric | Before | After | Change |
|---|---|---|---|
| Issue创建耗时 | 120min | 15min | -87% |

## Readme

# triage-issue

# Triage Issue

Investigate a reported problem, find its root cause, and create a GitHub issue with a TDD fix plan. This is a mostly hands-off workflow - minimize questions to the user.

## Process

### 1. Capture the problem

Get a brief description of the issue from the user. If they haven't provided one, ask ONE question: "What's the problem you're seeing?"

Do NOT ask follow-up questions yet. Start investigating immediately.

### 2. Explore and diagnose

Use the Agent tool with subagent_type=Explore to deeply investigate the codebase. Your goal is to find:

- **Where** the bug manifests (entry points, UI, API responses)

- **What** code path is involved (trace the flow)

- **Why** it fails (the root cause, not just the symptom)

- **What** related code exists (similar patterns, tests, adjacent modules)

Look at:

- Related source files and their dependencies

- Existing tests (what's tested, what's missing)

- Recent changes to affected files (`git log` on relevant files)

- Error handling in the code path

- Similar patterns elsewhere in the codebase that work correctly

### 3. Identify the fix approach

Based on your investigation, determine:

- The minimal change needed to fix the root cause

- Which modules/interfaces are affected

- What behaviors need to be verified via tests

- Whether this is a regression, missing feature, or design flaw

### 4. Design TDD fix plan

Create a concrete, ordered list of RED-GREEN cycles. Each cycle is one vertical slice:

- **RED**: Describe a specific test that captures the broken/missing behavior

- **GREEN**: Describe the minimal code change to make that test pass

Rules:

- Tests verify behavior through public interfaces, not implementation details

- One test at a time, vertical slices (NOT all tests first, then all code)

- Each test should survive internal refactors

- Include a final refactor step if needed

- **Durability**: Only suggest fixes that would survive radical codebase changes. Describe behaviors and contracts, not internal structure. Tests assert on observable outcomes (API responses, UI state, user-visible effects), not internal state. A good suggestion reads like a spec; a bad one reads like a diff.

### 5. Create the GitHub issue

Create a GitHub issue using `gh issue create` with the template below. Do NOT ask the user to review before creating - just create it and share the URL.

## Problem

A clear description of the bug or issue, including:

- What happens (actual behavior)

- What should happen (expected behavior)

- How to reproduce (if applicable)

## Root Cause Analysis

Describe what you found during investigation:

- The code path involved

- Why the current code fails

- Any contributing factors

Do NOT include specific file paths, line numbers, or implementation details that couple to current code layout. Describe modules, behaviors, and contracts instead. The issue should remain useful even after major refactors.

## TDD Fix Plan

A numbered list of RED-GREEN cycles:

- 

**RED**: Write a test that [describes expected behavior]
**GREEN**: [Minimal change to make it pass]

- 

**RED**: Write a test that [describes next behavior]
**GREEN**: [Minimal change to make it pass]

...

**REFACTOR**: [Any cleanup needed after all tests pass]

## Acceptance Criteria

-  Criterion 1

-  Criterion 2

-  All new tests pass

-  Existing tests still pass

After creating the issue, print the issue URL and a one-line summary of the root cause.
Weekly Installs210Repository[mattpocock/skills](https://github.com/mattpocock/skills)GitHub Stars4.6KFirst Seen6 days agoSecurity Audits[Gen Agent Trust HubPass](/mattpocock/skills/triage-issue/security/agent-trust-hub)[SocketPass](/mattpocock/skills/triage-issue/security/socket)[SnykPass](/mattpocock/skills/triage-issue/security/snyk)Installed oncodex205opencode204gemini-cli203github-copilot202kimi-cli202cursor202

---
*Source: https://skills.yangsir.net/skill/daily-triage-issue*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-triage-issue/markdown*