Agent skill

Root Cause Analysis

by zj-unicom-ai in zj-unicom-ai/UniEmployee

问题诊断与归因分析技能。当用户报告指标异常、数据波动、KPI未达标、营收下滑、成本上升时使用. An agent skill from zj-unicom-ai/UniEmployee.

MITAuto-check passedDevelopment

Install Root Cause Analysis

skills CLI
$ npx skills add zj-unicom-ai/UniEmployee --skill root-cause-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zj-unicom-ai/UniEmployee root-cause-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zj-unicom-ai/UniEmployee.git skills-src && mkdir -p .claude/skills && cp -r skills-src/backend/skills/root-cause-analysis .claude/skills/root-cause-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
root-cause-analysis
GitHub stars
360
Token cost
~204 tokens
SKILL.md length
42 words
Files
1
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

问题诊断与归因分析技能。当用户报告指标异常、数据波动、KPI未达标、营收下滑、成本上升时使用. An agent skill from zj-unicom-ai/UniEmployee.

  • Works in 3 steps: 异常定位 -- 哪个月、哪个维度、偏离多少 → 根因判断 -- 量因还是价因?哪个区域/产品拖累最大? → 建议方向 --…
  • Tasks that involve Root cause analysis
  • SKILL.md covers 适用范围, 执行步骤 and 约束
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Root Cause Analysis is an agent skill from zj-unicom-ai/UniEmployee. 问题诊断与归因分析技能。当用户报告指标异常、数据波动、KPI未达标、营收下滑、成本上升时使用。

Its SKILL.md is about 200 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Root cause analysis and OKRs and executive reporting. The repository describes itself as: 面向企业的数字员工构建与运行平台:把专业员工的经验、流程与判断标准,固化为可随时上岗、可配置、可审批、可观测的 AI 数字员工。 The licence is MIT.

When your agent uses it

  • Tasks that involve Root cause analysis
  • Tasks that involve OKRs and executive reporting

Example prompts

  • “/root-cause-analysis”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 异常定位 -- 哪个月、哪个维度、偏离多少
  2. 根因判断 -- 量因还是价因?哪个区域/产品拖累最大?
  3. 建议方向 -- 量的问题检查营销/竞品;价的问题分析产品结构变化;区域性问题下钻该区域

What it can do on your machine

Read from SKILL.md and the folder at commit c38a00a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Root Cause Analysis loads about 204 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 42 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~204

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from zj-unicom-ai/UniEmployee at commit c38a00a, republished under its MIT licence (© zj-unicom-ai). 42 words, ~204 tokens.

Download SKILL.mdSave it as .claude/skills/root-cause-analysis/SKILL.md (or your agent's skills folder).
name
root-cause-analysis
description
问题诊断与归因分析技能。当用户报告指标异常、数据波动、KPI未达标、营收下滑、成本上升时使用。

问题诊断与归因分析

你是问题诊断专家,接到异常分析请求时严格按以下规程执行。

适用范围

  • 营收/利润/订单量异常波动(环比或同比变化超15%)
  • 某地区/产品/渠道表现显著偏离整体趋势
  • 成本异常上升或利润率非预期下降
  • 客户指标异常(复购率骤降、获客成本飙升等)

执行步骤

步骤1:确认异常事实

先用 run_python 确认异常是否真实存在及其幅度,输出月度营收/利润/订单量表及环比变化率。

重点是确定:哪个月份、哪个维度(地区/产品/渠道)出现异常,偏离幅度多少。

步骤2:拆解归因(收入归因)

使用杜邦分解法拆营收变化。按产品分组聚合目标月与上月数据,计算件均价和笔单价。 判断是"量"的问题还是"价"的问题:

  • 订单量下滑 -> 需求侧问题(市场萎缩/竞品冲击/营销不足)
  • 件均价下降 -> 定价或产品结构变化(低端品占比上升)
  • 笔单价下降 -> 客单价降低(满减/折扣/凑单减少)
步骤3:区域与渠道拆解

按地区聚合当月与上月数据,计算营收变化量与变化率,排序输出降幅最大的区域。 同样按渠道做一次。

步骤4:综合诊断结论

把步骤1-3的真实数字整合成三段式结论:

  1. 异常定位 -- 哪个月、哪个维度、偏离多少
  2. 根因判断 -- 量因还是价因?哪个区域/产品拖累最大?
  3. 建议方向 -- 量的问题检查营销/竞品;价的问题分析产品结构变化;区域性问题下钻该区域

约束

  • 每个结论必须有 run_python 跑出的数字支撑。
  • 避免单一归因,经营指标波动通常是多因素叠加。
  • 归因之后必须有可执行的建议。

© zj-unicom-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in backend/skills/root-cause-analysis of zj-unicom-ai/UniEmployee.

Open the folder on GitHubat commit c38a00a

Compare with similar skills

Root Cause Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Root Cause Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Root Cause Analysis this skillzj-unicom-ai/UniEmployee360—~204Automated safety check: PassMIT
Project Intelligence Timeline Dashboardpnp/sharepoint-skills133—~2.8kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins11k9 repos~2.6kAutomated safety check: PassNone
OpenLogi macOS Permissions TriageAprilNEA/OpenLogi23k—~2.5kAutomated safety check: NotesApache-2.0
Bug Finder for daisyUIsaadeghi/daisyui43k—~2.3kAutomated safety check: PassMIT
Root Cause Debugginggarrytan/gstack136k—~1.4kAutomated safety check: PassMIT

Similar skills

  • Generates a self-contained, dependency-free HTML timeline dashboard that visualises the Project Intelligence Engine output — KPI bar, planned-vs-actual contrast panel, root cause, causal chain…

    133 GitHub stars~2.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    11k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Bug Finder for daisyUI

    saadeghi/daisyui

    Investigates suspected bugs in the daisyUI monorepo through read-only analysis, then writes a decision-ready fix plan in tmp/bugs without changing any product code.

    43k GitHub stars~2.3k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Root Cause Debugging

    garrytan/gstack

    Investigates bugs, errors and stack traces in phases and requires a root-cause hypothesis to be confirmed before any fix is written.

    136k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Review PR

    apache/shardingsphere

    Review Apache ShardingSphere or user-authorized downstream pull requests and PR discussions from public or authorized repository evidence.

    21k GitHub stars~6.4k tokensUpdated today
    DevelopmentAuto-check passed

More from zj-unicom-ai/UniEmployee

All 22 skills in this repo
  • Enterprise Customer Visit Playbook

    zj-unicom-ai/UniEmployee

    Prepares account managers for visits to government and enterprise customers: looks up the customer file, matches products, builds a Word solution document and files visit minutes.

    360 GitHub stars~458 tokensUpdated 2 days ago
    Auto-check passed
  • Tencent ima Knowledge Base Reader

    zj-unicom-ai/UniEmployee

    Exports the article list and original article text from a Tencent ima knowledge base through a logged-in Chrome session, using browser automation.

    360 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed
  • Business Overview Analysis

    zj-unicom-ai/UniEmployee

    Produces a full business health analysis from sales, finance, inventory and customer CSV files: core KPIs, monthly trends, drill-downs and recommendations.

    360 GitHub stars~662 tokensUpdated 2 days ago
    Auto-check passed
  • Competitor Deep-Dive Dashboard

    zj-unicom-ai/UniEmployee

    Produces a competitor benchmarking dashboard as an HTML page with an ECharts price comparison, from built-in profile cards plus fresh web research.

    360 GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Insurance Operations Analysis

    zj-unicom-ai/UniEmployee

    Analyzes insurance operating data such as premium, loss ratio, renewal rate and expense ratio by branch, product and channel, flags anomalies and builds an HTML dashboard.

    360 GitHub stars~646 tokensUpdated 2 days ago
    Auto-check passed
  • Market Alert Triage

    zj-unicom-ai/UniEmployee

    Assesses a reported market event such as a competitor price cut, new launch or negative press, verifies it, grades urgency from P0 to P2 and produces a short alert card.

    360 GitHub stars~778 tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Root Cause Analysis

What does Root Cause Analysis do?

问题诊断与归因分析技能。当用户报告指标异常、数据波动、KPI未达标、营收下滑、成本上升时使用. An agent skill from zj-unicom-ai/UniEmployee. Root Cause Analysis is an agent skill from zj-unicom-ai/UniEmployee.

When should I use Root Cause Analysis?

Root Cause Analysis fits situations like: tasks that involve Root cause analysis; tasks that involve OKRs and executive reporting.

How do I install Root Cause Analysis in Claude Code?

Run `npx skills add zj-unicom-ai/UniEmployee --skill root-cause-analysis -a claude-code`. Or copy the skill folder (backend/skills/root-cause-analysis in zj-unicom-ai/UniEmployee) into .claude/skills/root-cause-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Root Cause Analysis in Codex?

Run `npx skills add zj-unicom-ai/UniEmployee --skill root-cause-analysis -a codex`. Or copy the skill folder (backend/skills/root-cause-analysis in zj-unicom-ai/UniEmployee) into .agents/skills/root-cause-analysis in your project. Codex loads it when a task matches its description.

Can I use Root Cause Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zj-unicom-ai/UniEmployee --skill root-cause-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/root-cause-analysis, .gemini/skills/root-cause-analysis, .github/skills/root-cause-analysis and .opencode/skills/root-cause-analysis in your project.

What does Root Cause Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Root Cause Analysis is instructions for the agent only.

Does Root Cause Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Root Cause Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Root Cause Analysis use?

Root Cause Analysis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Root Cause Analysis use?

About 204 tokens (SKILL.md is roughly 816 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Root Cause Analysis?

Skills that share tags, products or a category with Root Cause Analysis: Project Intelligence Timeline Dashboard (pnp/sharepoint-skills, 133 stars), Code Design Rationale Investigator (cursor/plugins, 11k stars), OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars) and Bug Finder for daisyUI (saadeghi/daisyui, 43k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Root Cause Analysis?

zj-unicom-ai (a GitHub organization) maintains it in zj-unicom-ai/UniEmployee, which has 360 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 8, 2026.

Source: zj-unicom-ai/UniEmployee on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.