Table Design Advisor

Use when designing or reviewing a data warehouse table schema. Advises on warehouse layer, table grain, fact or dimension modeling, fields, primary key, partitioning, update strategy, lifecycle, naming, downstream usage, and data quality checks. 中文触发词:表设计、数仓建模、表结构审查、表粒度、分区设计。

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add shisuidata/ss-data-skills --skill table-design-advisor
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/table-design-advisor ~/.claude/skills/table-design-advisor

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

From the SKILL.md

# Table Design Advisor

## 目标

设计或审查一张数据表,使它的业务粒度、字段结构、更新策略和下游使用方式清晰可靠。

这个 Skill 适用于数仓建模和数据开发中的表设计。它不强制某一种公司规范,但会显式说明设计假设。

## 使用场景

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

- 新建 ODS、DWD、DWS、ADS 表
- 设计事实表、维表、明细表、汇总表或宽表
- 审查已有表结构是否合理
- 判断表粒度、主键、分区、更新方式
- 为看板、指标、推荐、风控、运营分析等场景设计数据集
- 将临时 SQL 产出沉淀成可维护的数据表

典型输入:

```text
我要做一张用户首购转化明细表,给渠道看板使用。
```

```text
帮我审查这张订单宽表设计是否合理。
```

## 不适用场景

不要用这个 Skill 直接完成:

- 模糊需求澄清,请使用 `data-requirement-clarifier`
- 指标口径审查,请使用 `metric-definition-reviewer`
- SQL 审查,请使用 `sql-reviewer`
- 数据质量规则生成,请使用 `data-quality-rule-generator`

如果业务口径尚未明确,先输出设计假设和待确认问题,不要直接生成确定方案。

## 输入信息

最少输入:

- 业务场景
- 表的预期用途

可选输入:

- 指标口径
- 查询场景
- 上游表
- 下游看板或任务
- 数据量级
- 更新频率
- 数据延迟要求
- 保留周期
- 执行引擎
- 公司命名规范

## 上下文建议

推荐使用 [表设计上下文模板](../../context/templates/table-context.md)。

最有价值的上下文是:表服务的业务场景、数据粒度、上游数据、下游查询、更新频率、数据量级和保留周期。表粒度不清楚时,必须先澄清“一行代表什么”。

## 设计框架

逐项设计:

1. 表定位:ODS、DWD、DWS、ADS 或应用层数据集。
2. 表类型:事实表、维表、明细表、汇总表、宽表、快照表、拉链表。
3. 业务粒度:一行代表什么,这是表设计的核心。
4. 主键或唯一键:如何唯一识别一行。
5. 时间字段:业务发生时间、状态更新时间、入仓时间、分区时间。
6. 分区策略:按日期、小时、组织、区域或其他字段分区。
7. 更新策略:增量、全量、快照、拉链、覆盖、追加。
8. 字段设计:维度字段、指标字段、状态字段、审计字段。
9. 命名建议:表名、字段名、注释要表达业务含义。
10. 下游使用:查询路径、常见过滤条件、聚合维度。
11. 数据质量:非空、唯一、枚举、波动、关联完整性等。
12. 生命周期:保留周期、归档策略、重刷成本。

快照、拉链、宽表等模式的取舍见 [建模模式](references/modeling-patterns.md)。

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

Details

Skill name
table-design-advisor
Path
skills/table-design-advisor/SKILL.md
License
MIT
Repo updated
8 November 2026

FAQ

What does the Table Design Advisor skill do?

Use when designing or reviewing a data warehouse table schema. Advises on warehouse layer, table grain, fact or dimension modeling, fields, primary key, partitioning, update strategy, lifecycle, naming, downstream usage, and data quality checks. 中文触发词:表设计、数仓建模、表结构审查、表粒度、分区设计。

How do I install the Table Design Advisor skill?

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

Is Table Design Advisor 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

Workers AI

9

zllovesuki/cloudflare-agent-skills

Write Cloudflare Workers AI and AI Gateway code for model inference, prompts, streaming, token budgets, model selection, observability, and fallback design. Use when adding LLM, embeddings, summarization, classification, or generation to Workers.

AI, LLMs & Agents

Storage Selection

9

zllovesuki/cloudflare-agent-skills

Choose the right Cloudflare storage primitive: D1, R2, KV, Durable Object storage, Hyperdrive, Vectorize, AI Search, cache, or external databases. Use before modeling data, writing migrations, or deciding consistency/cost trade-offs.

AI, LLMs & Agents

Agent Design Review

5

nekoai-lab/claude-skills

AIエージェントの仕様書・要件定義・設計ドキュメントをレビューするスキル。ユーザーが「仕様書を見て」「設計レビューして」「これで問題ないか確認して」「エージェント設計のフィードバックほしい」などと言ったとき、またはエージェント設計に関する判断を求められたときに必ず使う。ハーネス設計・ツール分類・コンテキスト設計・マルチエージェント構成・陳腐化リスクの5軸で問題を検出し、具体的な改善案を返す。

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.