fix-with-rca

Diagnose and fix bugs using a structured four-part root cause analysis workflow.

Updated May 16, 2026
One-click install
npx skills add https://github.com/alimtvnetwork/img-pdf-v2 --skill fix-with-rca-alimtvnetwork
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-with-rca
Source: https://github.com/alimtvnetwork/img-pdf-v2/tree/main/.agents/skills/fix-with-rca
Command: npx skills add https://github.com/alimtvnetwork/img-pdf-v2 --skill fix-with-rca-alimtvnetwork

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging often devolves into guesswork and repeated trial-and-error fixes that never address the real failure mechanism. This Skill enforces a disciplined four-part Root Cause Analysis (RCA) process so every bug fix is grounded in evidence, documented, and prevented from recurring. ## Core Features & Use Cases - Structured 4-Part RCA: Documents Symptom, Root Cause, Resolution, and Prevention & Learnings for every bug, producing an auditable record instead of an ad-hoc patch. - CI/CD Pipeline Diagnosis: Integrates with GitMap pipeline-ai commands to extract targeted failure lines (e.g., ##[error], compile errors) instead of dumping entire logs, and uses adaptive ETA-based waiting to avoid wasteful tight polling loops. - Persistent Issue Logging: Writes RCA reports to .ai-memory/issues/ for general bugs and .ai-memory/cicd-issues/ for pipeline failures, building an organizational knowledge base. - Use Case: A CI build fails with a cryptic error. The agent inspects the pipeline via gitmap pipeline-ai status --json, extracts only the failing lines, writes a 4-part RCA identifying the exact root cause, applies a minimal fix, and logs the prevention rule for future runs. ## Quick Start Ask the agent to diagnose the current failing test or CI pipeline failure and produce a root cause analysis before applying any fix.

Frequently Asked Questions about fix-with-rca

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

FAQPage Schema
How do I fix a bug using root cause analysis instead of guessing?

Follow the four-part RCA structure: capture the Symptom (raw error output and reproduction steps), state the Root Cause in one sentence, apply a minimal Resolution, and record Prevention & Learnings. This ensures the fix targets the actual failure mechanism.

How do I diagnose a failing CI/CD pipeline without reading entire logs?

Use `gitmap pipeline-ai status --json` to inspect pipeline status and extract only targeted failure lines such as `##[error]`, `FAIL:`, or compile errors. Feed those lines directly into the RCA document instead of dumping full passing logs.

Why is rapid polling of CI pipeline status discouraged?

Tight-loop polling with commands like `gh run view` burns API credits without adding information. Instead, use `gitmap pipeline-ai status -t <etaSeconds>` to wait dynamically based on historical completion ETA, with sleep intervals scaled to the remaining time.

Where are root cause analysis reports stored?

General bug RCAs are logged to `.ai-memory/issues/01-<slug>.md`, while CI/CD failure RCAs go to `.ai-memory/cicd-issues/01-<slug>.md`. This separation keeps pipeline diagnostics distinct from application bug history.

When should I use structured RCA versus a quick hotfix?

Use structured RCA for recurring bugs, CI/CD failures, or any issue where the failure mechanism is unclear. A quick hotfix is acceptable only for trivial, well-understood typos; anything else risks masking the real root cause.