Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

root-cause-analysis

/root-cause-analysis

Śledzi dokładną przyczynę potwierdzonego błędu w kodzie przed zaproponowaniem poprawki i zapisuje wynik w zgłoszeniu, bez edycji kodu.

Repozytorium
sdlc-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Śledzi dokładną przyczynę potwierdzonego błędu w kodzie przed zaproponowaniem poprawki i zapisuje wynik w zgłoszeniu, bez edycji kodu.

Wyzwalacze z opisu

investigate issue
Oryginalny opis (EN)

Use when a bug has been reproduced or confirmed and needs its exact cause traced before a fix is proposed, or when the user says 'investigate issue'. Traces a bug to its exact cause in the codebase. Investigation only — reports the cause on the ticket; does not edit code.

Jak działa

  1. Platform & systems
  2. When to use
  3. Methodology — 4 phases
  4. You do NOT
  5. Related skills
Sekcje z nagłówków SKILL.md, w oryginale · 88 linii, 565 słów
Podgląd SKILL.md
---
name: root-cause-analysis
description: Use when a bug has been reproduced or confirmed and needs its exact cause traced before a fix is proposed, or when the user says 'investigate issue'. Traces a bug to its exact cause in the codebase. Investigation only — reports the cause on the ticket; does not edit code.
license: Apache-2.0
metadata:
  authors:
    - Artem Rozumenko <artem_rozumenko@epam.com>
  version: "0.1.0"
---

# Root-Cause Analysis (RCA)

Trace a confirmed bug to its exact cause and produce a structured RCA
artifact. **Investigation only — you do NOT edit code, branch, or fix.**

## Platform & systems

The RCA report goes on the **tracker ticket** — the source of truth — using
the tracker scout recorded in `.agents/profile.md § Project systems`. The
`gh issue …` commands below are the **GitHub reference**; translate per
`.agents/workflow.md § Git host`. With no tracker, report directly to the user.

## When to use

Pairs with **`systematic-debugging`** — use its rigor (reproduce reliably,
condition-based waiting) to trace, then produce the structured report here.

## Methodology — 4 phases

### 1. Ticket acquisition

Read the ticket and all comments (reproduction steps, errors, stack traces,
environment, prior notes). Note that RCA has started on the ticket.

### 2. Codebase investigation — trace, don't guess

- **Locate the entry point**: grep the error message / function / route.
- **Trace the call chain**: entry (route/handler) → service (logic) → data
  layer → failure point. Read each file in the chain.
- **Examine the failure point**: which assumption is violated? what input
  triggers it? is the bug here or in a dependency?
- **Search for patterns**: how is the function called elsewhere; are there
  similar patterns that work; `git blame` and recent `git log` on the file.

### 3. Root-cause determination

Classify the cause:

| Category | Description | Example |
|---|---|---|
| **Logic** | Wrong condition, missing branch, off-by-one | `if x > 0` should be `if x >= 0` |
| **Data** | Unexpected input, null handling, type mismatch | Missing null check on optional field |
| **Concurrency** | Race condition, missing lock, async issue | Two requests mutating the same resource |
| **Configuration** | Wrong default, missing env var | Timeout too low for large payloads |
| **Integration** | API contract / dependency version change | Third-party API changed its response shape |
| **Resource** | Memory, connection pool, file handles | DB connection pool exhausted |

State **confidence**: Confirmed (you can see the exact bug) / Highly likely /
Suspected.

### 4. Impact analysis & report

- **Usage**: what else calls the buggy code; what depends on the module.
- **Regression risk**: what could break if fixed; existing test coverage;
  whether the code is shared across features.
- **Post the RCA report on the ticket**: executive summary, classification
  (category / confidence / severity), root cause (location `file:line` +
  function + cause + the offending code), execution path, impact analysis,
  suggested remediation, and dependencies (what this blocks / relates to).
- **One line to user/PM**: root cause + location + confidence.

**RCA comment template:**

```
## Root Cause — <ticket-id>

**Summary:** <what & why, one paragraph>
**Classification:** <Logic|Data|Concurrency|Configuration|Integration|Resource> · confidence <Confirmed|Likely|Suspected> · severity <…>
**Root cause:** `path/to/file.ext:line` in `<function>` — <the offending logic>
**Execution path:** <entry → … → failure point>
**Impact:** <callers / regression risk / test coverage>
**Suggested remediation:** <fix direction, not the patch>
**Blocks / relates to:** <links>
```

## You do NOT

Edit source, create PRs/branches, run the app to fix it, make architecture
decisions, or close/reassign tickets. Hand the structured RCA to the developer
(or `bugfix-workflow`) for the fix.

## Related skills

- **`reproducing-issues`** precedes this — confirm the bug first.
- **`systematic-debugging`** for tracing rigor.
- **`bugfix-workflow`** consumes the RCA to implement and verify the fix.
Pliki w paczce (2)
  • README.md 1 KB
  • SKILL.md 4 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · arozumenko/sdlc-skills100MIT
qa-aman/claude-skills100MIT
robert-adunka/triz-skills100MIT
arjunprabhulal/devops-skills100MIT
static-var/keystone100MIT
rohitg00/skillkit100Apache-2.0
microsoft/hve-core95MIT
VoDaiLocz/kilo-kit-mcp95Apache-2.0
autohandai/code-cli90Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 01d5e4b15517 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100rca-investigator
    Prowadzi analizę przyczyn źródłowych potwierdzonego błędu: śledzi ścieżki kodu i zależności, wskazuje dokładne miejsce i przyczynę oraz dokumentuje ustalenia bez naprawiania kodu.
  • 100bug-investigation-notes
    Prowadzi notatki z szukania błędu: objawy, kroki odtworzenia, hipotezy, przyczynę i test regresyjny.
  • 100om-root-cause
    Diagnozuje w trybie tylko do odczytu potwierdzony błąd z trackera: lokalizuje przyczynę i zakres minimalnych zmian przed wdrożeniem.
  • 100triage
    Bada błąd, znajduje jego przyczynę i zapisuje rekord triage z planem poprawki opartym na TDD.
  • 100triage-issue
    Bada zgłoszony błąd do przyczyny źródłowej i tworzy plan poprawki w stylu TDD jako artefakt issue, zanim powstanie zmiana w kodzie.
  • 95triage-bug
    Prowadzi błąd z Jiry od zgłoszenia do przyczyny źródłowej i tworzy zadanie naprawy z testem odtwarzającym problem.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.