关于 statsig-create-cloud-metric
用于准备 Statsig Cloud 指标创建请求的 skill,涵盖必需输入、指标类型映射、筛选条件及 dry run 验证。
主要功能
- 01Cloud 指标输入清单
- 02指标类型枚举映射
- 03筛选与汇总设置指引
- 04dry run 请求配置
- 05curl 请求构造
适用场景
- 01编写 Cloud 指标 API 请求
- 02创建前验证指标
- 03选择受支持的筛选条件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ statsig-io/ agent-skills --skill statsig-create-cloud-metric安装后在 Claude Code 中输入/statsig-create-cloud-metric确认已加载。
附带文件references/cloud-metric-creation.mdreferences/create-metric-api.md
详细介绍
Statsig Create Cloud Metric API
快速入门
- 确认请求针对的是 Cloud 项目。
- 收集必填信息:指标名称、请求的指标类型,以及是否进行试运行。
- 查看 references/create-metric-api.md 中的共享契约指南。
- 查看 references/cloud-metric-creation.md。
- 使用 Cloud 参考文档,将请求的指标类型映射到 API
type枚举。 - 使用 STATSIG-API-KEY 和 JSON 正文编写 curl 请求。
必填信息
- 指标名称(4-200 个字符)。
- 请求的指标类型和 API
type枚举。 - 事件定义。
- 筛选条件和可选的汇总设置。
- 所选 Cloud 指标类型要求时,提供 unitTypes。
构建请求
- 始终发送
POST /console/v1/metrics。 - 始终包含
Content-Type: application/json和STATSIG-API-KEY。 - 对于优先验证的工作流,使用
dryRun: true。 - 如果 SQL 筛选条件中包含单引号,优先使用 heredoc 负载(
--data-binary @- <<'JSON'),而不是内联-d '...'JSON。 - 对于 Cloud 指标,设置
metricEvents、funnelEventList和metricComponentMetrics等顶层字段。 - 对于基于条件的筛选,仅使用 API 支持的
condition枚举值(参见 references/create-metric-api.md)。不要使用eq等别名。 - 最终确定前,先根据 Cloud 参考文档确认枚举映射和必填字段。
参考资料
- 共享 API 契约和请求头:
references/create-metric-api.md - Cloud 指标创建详情:
references/cloud-metric-creation.md
评论
支持 Markdown