AgentSkillsCN

Root Cause Analysis Skill

直击问题根源，而非只关注表象症状。

SKILL.md
--- frontmatter
name: "Root Cause Analysis Skill"
description: "Find the true source, not symptoms."
applyTo: "**/*debug*,**/*error*,**/*bug*,**/*issue*,**/*problem*"

Root Cause Analysis Skill

Find the true source, not symptoms.

Core Principle

Fixing symptoms creates more symptoms. Fix root cause.

5 Whys

Ask "Why?" until you reach the systemic issue.

Trap: Don't stop at "human error." Ask why the mistake was possible.

Cause Categories

CategoryExamples
CodeBug, validation, race condition
DataCorrupt, unexpected input
InfrastructureServer, network, disk
DependenciesThird-party, library version
ConfigurationEnv vars, feature flags
ProcessMissing review, unclear requirements

Timeline Analysis

TimeEventNotes

Look for: What changed? What correlates?

Fix + Prevent Pattern

  1. •Immediate: Stop the bleeding
  2. •Permanent: Fix root cause
  3. •Prevention: Stop recurrence

Common Patterns

SymptomLikely Cause
Memory leakUnclosed resources
Slow performanceN+1 queries, missing indexes
Intermittent failuresRace conditions
Data corruptionMissing validation

Post-Mortem

Summary → Timeline → Root Cause → Action Items (owner + due)

Synapses

See synapses.json for connections.