本文へ移動
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

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

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 のスキルをすべて見る

このスキルの問題を報告する