본문으로 건너뛰기
cccskills
무료GitHub에 공개

codexkit-root-cause-analyzer

Conduct structured root cause analysis using Ishikawa (Fishbone), 5 Whys, and Pareto methods. Suitable for production incidents, quality defects, customer complaints, and recurring operational problems. Use when problems recur or when initial fixes do not resolve the issue. Do not use for one-time, obvious fixes or strategic decision-making.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(5)

  • SKILL.md4.9 KB
  • agents/openai.yaml168 B
  • examples/common-mistakes.md811 B
  • examples/good-output.md887 B
  • verification/checklist.md1.3 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Root Cause Analyzer

Purpose

Move beyond symptomatic fixes to identify true root causes of recurring problems, using proven analytical methods and producing actionable corrective actions.

When to use

  • a problem has occurred more than once despite previous fixes
  • a production incident needs thorough investigation
  • quality defects are increasing and the cause is unclear
  • customer complaints cluster around a specific area
  • post-mortem or incident review

When not to use

  • the cause is obvious and the fix is straightforward
  • strategic planning (use strategy tools)
  • risk identification for future events (use risk-register)

Inputs

  • problem statement (what happened, when, how bad)
  • impact data (who was affected, financial cost, customer impact)
  • timeline of events leading to the problem
  • previous fix attempts and their outcomes
  • relevant process or system documentation
  • available data or metrics related to the problem

Procedure

  1. Define the problem precisely:
    • What is happening vs. what should be happening?
    • When did it start? How often does it occur?
    • What is the quantified impact?
    • Template: "[Thing] is [problem] resulting in [impact] since [when]"
  2. Choose analysis method based on problem type:
    • 5 Whys: for linear causation chains (simple to moderate)
    • Ishikawa / Fishbone: for complex problems with multiple potential causes
      • 6M categories: Man, Machine, Method, Material, Measurement, Mother Nature (Environment)
    • Pareto Analysis: when multiple causes contribute and you need to prioritize
      • 80/20 rule: find the 20% of causes responsible for 80% of the impact
  3. Execute analysis:
    • For 5 Whys: ask "why?" iteratively until you reach a systemic cause (typically 3–7 levels). Stop when the answer points to a process, policy, or system — not a person.
    • For Ishikawa: brainstorm causes in each 6M category, then validate with data.
    • For Pareto: list all contributing causes, quantify frequency or impact, sort descending, calculate cumulative %.
  4. Validate root cause — confirm it is:
    • Actionable (you can do something about it)
    • Preventable (fixing it prevents recurrence)
    • Systemic (not blaming an individual)
  5. Define corrective actions (CAPA framework):
    • Containment: immediate actions already taken
    • Corrective Action: fix the root cause
    • Preventive Action: prevent recurrence in similar processes
    • Each action: What | Who | When | Verification method
  6. Define recurrence metrics — how will you know it's fixed?

Output

  • problem statement (one clear sentence with impact data)
  • analysis output (5 Whys ladder, Fishbone diagram, or Pareto chart)
  • validated root cause with supporting evidence
  • CAPA table: Containment | Corrective | Preventive actions with owners and dates
  • recurrence monitoring plan

Definition of done

  • root cause is systemic, not individual blame
  • root cause is validated with evidence or data
  • corrective and preventive actions are defined with owners and due dates
  • recurrence metrics are established

Examples

  • "Our deployment failed 3 times this month. Run a 5 Whys analysis."
  • "Customer complaints about delayed invoices are increasing. Do a Fishbone analysis."
  • "We have 12 different bug types from last quarter. Use Pareto to prioritize which to fix first."

Quality Criteria

  • Steps are executable in sequence without external context
  • Decision points have clear if/then branching
  • Rollback or abort procedures are documented for risky steps
  • Expected duration or time-per-step is estimated

Verification (4C)

CheckQuestion
CorrectnessDo the steps execute correctly in the order specified?
CompletenessAre decision points, error handling, and escalation paths all documented?
Context-fitCould someone with the right access but no prior context complete this runbook?
ConsequenceIf Step N fails and the operator skips to Step N+1, what breaks?

Edge Cases

  • Steps require access the operator doesn't have — Document exact access requirements upfront. Include escalation contact for emergency access.
  • Environment differs from documented state — Add a pre-flight check as Step 0 to verify prerequisites before starting.
  • Runbook is triggered during off-hours — Document who to contact and which steps can be safely deferred to business hours.

Changelog

  • v1.0.0 — Initial release

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Design rigorous A/B test plans with hypothesis, sample size calculation, Minimum Detectable Effect (MDE), randomization strategy, and decision rules. Includes guardrail metrics and rollout playbook. Use when planning product experiments, conversion optimization, or data-driven feature decisions.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hoavdc/CodexKit252026년 10월 11일 업데이트

Review REST and GraphQL API designs for consistency, usability, and best practices. Covers naming conventions, versioning strategy, error format, pagination, authentication patterns, and breaking change detection. Use when reviewing API specs, designing new APIs, or auditing existing endpoints.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hoavdc/CodexKit252026년 10월 11일 업데이트

Write Architecture Decision Records (ADRs) following the Michael Nygard format. Captures context, options considered, decision rationale, and consequences. Use when making technology choices, framework selections, or any architectural decision that future developers need to understand.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hoavdc/CodexKit252026년 10월 11일 업데이트

Assess organizational readiness for financial audits (internal or external). Map assertions to account balances, check evidence completeness, score readiness using a Red/Amber/Green framework, and generate a remediation timeline. Aligned with SOX, IFRS, and GAAP audit standards. Use before scheduled audits or when preparing for first-time compliance.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hoavdc/CodexKit252026년 10월 11일 업데이트

Design safe recurring Codex automations with clear prompts, outputs, schedules, and gating rules.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hoavdc/CodexKit252026년 10월 11일 업데이트

Refine Product Backlog Items to meet INVEST criteria. Write User Stories with Acceptance Criteria in Given/When/Then format, estimate with Story Points, and flag dependencies. Use before sprint planning when backlog items need grooming. Do not use to prioritize the backlog — that is the Product Owner's decision.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hoavdc/CodexKit252026년 10월 11일 업데이트

hoavdc의 스킬 모두 보기

이 스킬의 문제 신고