Title: Wave Skills
Locale: zh
URL: https://sensorswave.cn/docs/ai/wave-skills/
Description: 为 Cursor、Claude Code、Codex 提供面向埋点规划、SDK 接入与数据分析的 Wave Skills。
Wave Skills 是一组面向 Sensors Wave 场景的 Skills，建立在 [MCP 接入](mcp.mdx) 之上。它不是用来替代 MCP 的，而是把 MCP 提供的工具能力整理成更稳定、更顺手的使用方式。

目前这组 Skills 由一个总入口、三个 tracking workflow、一个 analytics workflow 和一个内部 shared 包组成：

- **wave**：总入口，根据用户当前阶段把请求路由到对应 workflow
- **wave-tracking-plan**：埋点方案规划、事件命名、服务端 vs 客户端选型、identify 方案
- **wave-tracking**：Tracking Plan 写入、发布、质检、Dashboard 启动版
- **wave-sdk-integration**：Pipeline / SDK 初始化 / identify / reset / 代码接入
- **wave-analytics**：事件分析、漏斗分析、留存分析、用户列表、行为序列、自定义 SQL
- **wave-tracking-shared**：内部共享的 prompts / policies / references，用于承载统一规则而不是直接面向终端用户执行

其中根级的 `wave` 作为路由入口，会根据用户意图自动把请求分发到对应子 Skill。

## 适合什么场景

如果你经常在 Cursor、Claude Code、Codex 里做下面这些事，建议安装 Wave Skills：

- 根据代码、PRD、页面流程整理埋点方案和事件表
- 在项目里创建或更新 Pipeline、Tracking Plan、Dashboard
- 按固定流程做事件分析、漏斗分析、留存分析或 SQL 查询
- 希望回答更贴近 Sensors Wave 的命名规范、工具顺序和交付格式

## 与 MCP 的关系

- **MCP**：提供项目、埋点、分析、Dashboard 等底层工具能力
- **Wave Skills**：规定什么时候调用哪些工具、先问什么、怎样组织输出

可以简单理解为：

- MCP 解决“能调用什么工具”
- Wave Skills 解决“常见任务按什么顺序推进”

## 包含哪些能力

Wave Skills 目前主要包含这些能力：

- **wave**：总入口，会根据你的当前阶段自动路由到对应流程
- **wave-tracking-plan**：埋点方案规划、代码盘点、identify 方案设计
- **wave-tracking**：Tracking Plan 写入、发布、质检和 Dashboard 启动版
- **wave-sdk-integration**：Pipeline、SDK 初始化、identify / reset 与代码接入
- **wave-analytics**：分析模型选择、查询参数组织和结果解读

## 安装方式

推荐直接用 GitHub `npx` 安装：

```bash
# 在当前项目里安装
npx github:sensorswave/agent-skills --project

# 安装到本机工具目录
npx github:sensorswave/agent-skills --cursor
npx github:sensorswave/agent-skills --claude
npx github:sensorswave/agent-skills --codex
```

这种方式默认走复制安装，适合 macOS / Linux / Windows，也不会把目标 `skills` 目录链接到 npm 缓存。

如果你是从 GitHub 克隆仓库来维护这套 Skills，或者希望安装目录保持符号链接、方便随 `git pull` 自动更新，再使用仓库内的 `install.sh`：

```bash
git clone https://github.com/sensorswave/agent-skills.git
cd agent-skills
./install.sh --all
```

如果你更习惯手动管理，也可以把各个 Skill 目录软链接到对应工具的 `skills` 目录下。

## 使用建议

推荐顺序如下：

1. 先完成 [MCP 接入](mcp.mdx)
2. 再安装 Wave Skills
3. 在工具里直接描述任务，例如“帮我设计注册到付费的埋点方案”或“分析最近 30 天注册用户的 7 日留存”

这样做的好处是，工具能力和任务流程都已经准备好，你只需要把业务问题说清楚即可。