名称：analytics-amplitude 描述：Amplitude产品分析。用于查询用户事件、漏斗、留存或产品使用数据。提供事件分割、用户活动查找和注释查询。允许工具：Bash(python *)

Amplitude 分析

认证

重要：凭证由代理层自动注入。不要检查环境变量中的 AMPLITUDE_API_KEY 或 AMPLITUDE_SECRET_KEY — 它们对您不可见。直接运行脚本；认证透明处理。

您可以检查的配置环境变量（非机密）：

AMPLITUDE_REGION — 区域：US（默认）或 EU

可用脚本

所有脚本位于 .claude/skills/analytics-amplitude/scripts/

query_events.py — 事件分割

查询事件计数、唯一用户数、随时间平均。这是主要的分析查询。

# 基本：计算触发事件的唯一用户数
python .claude/skills/analytics-amplitude/scripts/query_events.py \
  --event "Button Clicked" --start 2026-02-10 --end 2026-02-17

# 按属性分组
python .claude/skills/analytics-amplitude/scripts/query_events.py \
  --event "Page Viewed" --start 2026-02-10 --end 2026-02-17 \
  --group-by "platform"

# 每日间隔与总计指标
python .claude/skills/analytics-amplitude/scripts/query_events.py \
  --event "Error Occurred" --start 2026-02-10 --end 2026-02-17 \
  --interval daily --metric totals

# 带过滤器
python .claude/skills/analytics-amplitude/scripts/query_events.py \
  --event "Purchase Completed" --start 2026-02-10 --end 2026-02-17 \
  --filters '[{"subprop_type": "event", "subprop_key": "platform", "subprop_op": "is", "subprop_value": ["iOS"]}]'

参数：

--event（必需）：事件名称，必须与跟踪时完全一致
--start / --end（必需）：日期范围（YYYYMMDD 或 YYYY-MM-DD）
--interval：realtime、daily、weekly、monthly（默认：realtime）。注意：小时间隔并非在所有Amplitude计划中可用。
--metric：uniques、totals、avg、pct_dau（默认：uniques）
--group-by：要分割的事件属性
--filters：属性过滤器的JSON数组
--raw：输出完整的JSON响应

get_user_activity.py — 用户活动流

查找特定用户的事件流。用于调试用户报告的问题。

# 按用户ID
python .claude/skills/analytics-amplitude/scripts/get_user_activity.py --user "12345"

# 按电子邮件
python .claude/skills/analytics-amplitude/scripts/get_user_activity.py --user "user@example.com"

# 带分页
python .claude/skills/analytics-amplitude/scripts/get_user_activity.py --user "12345" --offset 100 --limit 50

参数：

--user（必需）：Amplitude用户ID或电子邮件
--offset：分页偏移（默认：0）
--limit：最大事件数（默认：100）
--raw：输出完整的JSON响应

get_chart_annotations.py — 注释

列出图表注释（部署标记、发布、功能标志）。

python .claude/skills/analytics-amplitude/scripts/get_chart_annotations.py

调查工作流

1. 发生了什么？
   └─→ query_events.py --event "Error Occurred" --interval daily
       （查看错误随时间趋势）

2. 谁受影响？
   └─→ query_events.py --event "Error Occurred" --group-by "user_id"
       （找到受影响用户）

3. 用户看到什么？
   └─→ get_user_activity.py --user "<user_id>"
       （追踪用户的完整事件流）

4. 有部署吗？
   └─→ get_chart_annotations.py
       （检查部署是否与错误峰值相关）

提示

事件名称是区分大小写的，必须与Amplitude中跟踪的完全匹配
日期格式：YYYYMMDD 或 YYYY-MM-DD（两者都可用）
任何脚本上的 --raw 标志为您提供完整的API响应以进行深入分析
对于时间序列分析，使用 --interval daily 或 --interval hourly
uniques 计算唯一用户数；totals 计算总事件触发数

名称：analytics-amplitude 描述：Amplitude产品分析。用于查询用户事件、漏斗、留存或产品使用数据。提供事件分割、用户活动查找和注释查询。 允许工具：Bash(python *)