Metric Definition Reviewer

Use when reviewing or defining a business metric, KPI, or analytics indicator. Checks business intent, population, event definition, time window, grain, filters, edge cases, status lifecycle, consistency, and questions that must be confirmed. 中文触发词:指标口径、口径审查、指标定义、分子分母。

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add shisuidata/ss-data-skills --skill metric-definition-reviewer
Manual install
git clone --depth 1 https://github.com/shisuidata/ss-data-skills.git /tmp/ss-data-skills
mkdir -p ~/.claude/skills
cp -r /tmp/ss-data-skills/skills/metric-definition-reviewer ~/.claude/skills/metric-definition-reviewer

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Metric Definition Reviewer

## 目标

审查一个指标口径是否清晰、稳定、可计算、可解释。

这个 Skill 关注指标本身,不负责完整建模,也不负责直接写生产 SQL。它要帮助用户发现口径漏洞、边界条件、业务歧义和跨团队对齐风险。

## 使用场景

使用这个 Skill,当用户需要:

- 定义一个新指标
- 审查已有指标口径
- 对齐业务方和数据团队对同一指标的理解
- 检查看板指标是否容易误导
- 分析 GMV、DAU、留存、转化率、复购率、活跃率、履约率等指标
- 在口径变更前明确新旧口径差异(下游影响范围请转 `data-lineage-impact-analyzer`)

典型输入:

```text
帮我审查一下“7 日留存率”的口径。
```

```text
GMV 现在按支付成功订单金额统计,退款是否扣减还没定。
```

## 不适用场景

不要用这个 Skill 直接完成:

- 模糊需求澄清,请使用 `data-requirement-clarifier`
- 表结构设计,请使用 `table-design-advisor`
- SQL 审查,请使用 `sql-reviewer`
- 数据质量规则生成,请使用 `data-quality-rule-generator`
- 评估口径变更对下游的影响,请使用 `data-lineage-impact-analyzer`

如果用户只提供了一个指标名,必须先列出待确认问题,不能直接给出确定口径。

## 输入信息

最少输入:

- 指标名称
- 当前口径或业务描述

可选输入:

- 业务目标
- 使用场景
- 统计对象
- 事件定义
- 时间窗口
- 统计粒度
- 过滤条件
- 订单、用户、商品、组织等状态流转规则
- 现有 SQL 或看板截图描述

## 上下文建议

推荐使用 [指标口径上下文模板](../../context/templates/metric-context.md)。

最有价值的上下文是:业务含义、统计对象、时间窗口、分子分母、过滤条件、去重规则和边界处理。缺少业务规则时,只能给出推荐口径和待确认问题,不能把行业常见口径当成事实。

## 审查框架

逐项检查:

1. 业务意图:这个指标被用来判断什么。
2. 统计对象:统计用户、订单、商品、设备、门店还是组织。
3. 事件定义:什么行为算发生,什么状态算有效。
4. 时间窗口:自然日、滚动窗口、T+1、支付时间、创建时间还是完成时间。
5. 统计粒度:日、周、月、用户、订单、渠道、组织等。
6. 分子分母:比率类指标必须明确分子、分母和样本范围。
7. 过滤条件:测试数据、内部账号、取消、退款、失败、异常状态是否排除。
8. 去重规则:按用户、订单、事件、设备还是业务主键去重。
9. 边界条件:跨天、跨月、退款、补单、延迟到账、状态回滚、重复上报。
10. 可解释性:业务方看到数值后是否能理解它代表什么。
11. 一致性:是否与已有指标、上游系统或财务口径冲突。

常见指标的提问清单见 [常见指标陷阱](references/metric-pitfalls.md)。里面是提问角度,不是标准答案。

## 输出格式
Read the full skill on GitHub

Details

Skill name
metric-definition-reviewer
Path
skills/metric-definition-reviewer/SKILL.md
License
MIT
Repo updated
8 November 2026

FAQ

What does the Metric Definition Reviewer skill do?

Use when reviewing or defining a business metric, KPI, or analytics indicator. Checks business intent, population, event definition, time window, grain, filters, edge cases, status lifecycle, consistency, and questions that must be confirmed. 中文触发词:指标口径、口径审查、指标定义、分子分母。

How do I install the Metric Definition Reviewer skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add shisuidata/ss-data-skills --skill metric-definition-reviewer. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Metric Definition Reviewer popular?

It lives in shisuidata/ss-data-skills, which has 9 GitHub stars and 0 forks.

Related skills

Ab Test Analysis

9

shisuidata/ss-data-skills

Use when designing, checking, or interpreting A/B tests and experiments. Computes significance, confidence intervals, sample ratio mismatch, power, CUPED, and sample size with a bundled zero-dependency script, then judges validity risks, guardrails, and ship/iterate/rollback decisions and renders an HTML experiment report. 中文触发词:A/B 实验、AB 测试、实验解读、显著性、样本量计算、能不能全量。

Testing & QA

Business Root Cause Analysis

9

shisuidata/ss-data-skills

Use when diagnosing business metric changes or anomalies such as GMV decline, conversion drop, retention loss, churn increase, revenue change, lead decline, or active user fluctuation with a structured root cause analysis plan. 中文触发词:指标归因、为什么下降、异常排查、GMV 下滑、指标波动原因。

Marketing, Sales & Business

Daily Report Writer

9

shisuidata/ss-data-skills

Use when writing a concise daily report, daily worklog, standup update, shift handoff, or end-of-day summary for data analysis, data development, BI, governance, or operations work. 中文触发词:日报、日终同步、站会发言、值班交接。

Writing & Content

Investigate

9

borkweb/skills

Find the root cause of an error, failing test, regression, slowdown or unexpected behavior before fixing it. Use for 'why is this failing', 'debug this', 'investigate', 'this broke after the upgrade' or 'figure out what's wrong'.

Finance & Crypto

Funnel Analysis

9

shisuidata/ss-data-skills

Use when analyzing conversion funnels across ordered business steps, such as registration, activation, payment, signup, onboarding, or checkout. Rebuilds strict ordered funnels from event data with a bundled zero-dependency script, decomposes period-over-period change into steps and into segment mix vs rate effects, detects tracking and truncation issues, and renders an HTML funnel report. 中文触发词:漏斗分析、转化漏斗、哪一步流失、转化率下降拆解。

Finance & Crypto

Alpha Vantage

9

huytran1120/vietnam-agentic-skills

Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators.

Finance & Crypto

Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.