Title: Wave Skills
Locale: zh
URL: https://sensorswave.com/docs/ai/wave-skills/
Description: 为 Cursor、Claude Code、Codex 提供面向埋点设计和数据分析的 Wave Skills。
Wave Skills 是一组面向 Sensors Wave 场景的 AI Agent Skill 封装，建立在 [MCP 接入](mcp.mdx) 之上。它的目标不是替代 MCP，而是把 MCP 提供的底层工具组织成更稳定、更可复用的工作流。

目前这组 Skills 主要覆盖两类任务：

- **wave-tracking**：埋点方案设计、事件命名、服务端 vs 客户端选型、Pipeline / Tracking Plan / SDK 初始化 / 质检 / Dashboard 闭环
- **wave-analytics**：事件分析、漏斗分析、留存分析、用户列表、行为序列、自定义 SQL

根目录的 `SKILL.md` 作为路由入口，会根据用户意图自动把请求分发到对应子 Skill。

## 适合什么场景

如果您在 AI Agent 工具里经常做以下工作，建议安装 Wave Skills：

- 让 AI Agent 协助设计埋点方案并给出可落地的事件表
- 让 AI Agent 在项目内完成 Pipeline、Tracking Plan、Dashboard 等操作
- 让 AI Agent 按固定流程做事件分析、漏斗分析、留存分析或 SQL 查询
- 希望 AI Agent 在回答时更贴近 Sensors Wave 的命名规范、工具顺序和交付格式

## 与 MCP 的关系

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

可以把它理解为：

- MCP 解决“AI Agent 能调用什么”
- Wave Skills 解决“AI Agent 应该怎么做”

## Skills 结构概览

根据 `agent-skills` 仓库当前内容，Wave Skills 主要由以下部分组成：

- 根级 `SKILL.md`：总入口，按用户意图路由到埋点或分析子 Skill
- `skills/wave-tracking/`：埋点规范、交互式确认流程、SDK 集成与质检指引
- `skills/wave-analytics/`：分析模型选择、MCP 查询参数构造、结果解读建议
- `docs/README.install.md`：安装说明
- `install.sh`：一键安装脚本，可装到 Cursor、Claude Code、Codex 或项目目录

## 安装方式

典型安装方式如下：

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

也可以只安装到指定平台或当前项目：

```bash
./install.sh --cursor
./install.sh --claude
./install.sh --codex
./install.sh --project
```

如果您更偏向手动管理，也可以把各个 Skill 目录软链接到对应 AI Agent 工具的 `skills` 目录下。

## 使用建议

推荐顺序如下：

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

这样做的好处是，AI Agent 不仅能访问项目数据和工具，还会按更接近实际业务流程的方式推进任务。