om-root-cause

Diagnoses tracker-reported bugs and defines the minimal code change set for downstream fix agents.

2.6k|159|Updated Mar 8, 2021
One-click install
npx skills add https://github.com/go-musicfox/go-musicfox --skill om-root-cause-go-musicfox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: om-root-cause
Source: https://github.com/go-musicfox/go-musicfox/tree/main/.agents/skills/om-root-cause
Command: npx skills add https://github.com/go-musicfox/go-musicfox --skill om-root-cause-go-musicfox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When an issue is confirmed as a real defect, someone still has to dig through the repository to find where the bug lives and what should change. This Skill performs that read-only root-cause analysis so the next agent in an automated fix chain can implement the fix without re-exploring the codebase. ## Core Features & Use Cases - Read-only investigation: Pulls the issue via the tracker get-issue operation, reads project docs, and traces the code path using only file reads and read-only git commands. - Minimal change definition: Identifies the smallest module or function that owns the bug and lists exact files to change, including regression tests. - Structured handoff report: Produces a plain-text report with summary, root cause, files to change, approach, and risks that the om-fix step consumes verbatim. - Use Case: In an autofix chain (om-verify-in-repo → om-root-cause → om-fix → om-open-pr), after an issue is verified as a real bug, this Skill locates the faulty function and hands a precise fix plan to the implementation agent. ## Quick Start Run the om-root-cause skill with the issue number to analyze the confirmed bug and produce a root-cause report for the fix agent.

Frequently Asked Questions about om-root-cause

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

FAQPage Schema
How do I find the root cause of a bug reported in an issue tracker?

Root-cause analysis starts by pulling the issue body and comments, then tracing the code path that produces the reported behavior. This Skill automates that flow read-only, ending with the exact files and functions that need to change.

What is the om-root-cause skill used for?

It is step 2 of an autofix chain that runs after a defect is verified and before the fix is implemented. It locates the bug, defines the minimal change set, and writes a structured report the om-fix agent acts on directly.

Can this skill modify code or commit changes?

No. It is strictly read-only: only file reads, code search, read-only git commands, and the tracker get-issue operation are allowed. It never edits files, commits, pushes, or mutates tracker state.

What happens if the root cause cannot be found confidently?

The analysis ends with a LOW_CONFIDENCE marker plus the best-guess analysis. The chain continues, but a human reviewer is expected to check the resulting fix more carefully.

Does root-cause analysis run the full test suite to confirm the bug?

No. It only confirms the bug when reproduction is cheap, such as a single failing test or quick command. Expensive validation suites are deferred to the om-fix step.