📝 docs(codex_skills): normalize markdown formatting

This commit is contained in:
csh
2025-12-22 15:36:58 +08:00
parent cc8ad4c59c
commit a52bb246ab
13 changed files with 109 additions and 2 deletions
+9
View File
@@ -6,30 +6,37 @@ description: "Root cause analysis (RCA) and tracing failures back to the origina
# Root Cause Tracing(根因溯源 / RCA
## When to Use
- Incidents, regressions, flaky tests, recurring bugs
- “Fix the symptom” patches where the underlying trigger is unknown
- Multi-layer failures (client → service → DB → async jobs)
## Inputsrequired
- Evidence: logs, stack traces, metrics, failing test output
- Timeline: when it started, what changed, rollout events
- Scope: affected users/paths, frequency, severity
- Verification: how to reproduce (or how to detect reliably)
## Proceduredefault
1. **Frame the Failure**
- Define expected vs actual behavior
- Identify the earliest known bad signal
2. **Trace Backwards**
- Walk back through layers: surface error → caller → upstream trigger
- Look for the first point where invariants were violated
3. **Find the Trigger**
- What input/state/sequence causes it?
- What changed around that area (code/config/deps/data)?
4. **Fix at the Right Layer**
- Prefer root-cause fix + defense-in-depth guardrails
- Add regression test or a deterministic repro harness
@@ -38,6 +45,7 @@ description: "Root cause analysis (RCA) and tracing failures back to the origina
- Add monitoring/alerts if appropriate
## Output Contractstable
- Summary: what broke and impact
- Root cause: the earliest causal violation + why it happened
- Trigger: minimal repro steps / conditions
@@ -46,6 +54,7 @@ description: "Root cause analysis (RCA) and tracing failures back to the origina
- Follow-ups: guardrails/observability/rollout notes
## Guardrails
- Dont stop at “where it crashed”; find “why the bad state existed”
- Separate contributing factors vs root cause
- Avoid speculative RCA; label assumptions and request missing evidence