mcpField
S
statsig-create-cloud-metric

statsig-create-cloud-metric

github.com/statsig-io数据与数据库477 次安装4 周前更新
代码仓库

关于 statsig-create-cloud-metric

用于准备 Statsig Cloud 指标创建请求的 skill,涵盖必需输入、指标类型映射、筛选条件及 dry run 验证。

主要功能

  1. 01Cloud 指标输入清单
  2. 02指标类型枚举映射
  3. 03筛选与汇总设置指引
  4. 04dry run 请求配置
  5. 05curl 请求构造

适用场景

  1. 01编写 Cloud 指标 API 请求
  2. 02创建前验证指标
  3. 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

快速入门

  1. 确认请求针对的是 Cloud 项目。
  2. 收集必填信息:指标名称、请求的指标类型,以及是否进行试运行。
  3. 查看 references/create-metric-api.md 中的共享契约指南。
  4. 查看 references/cloud-metric-creation.md。
  5. 使用 Cloud 参考文档,将请求的指标类型映射到 API type 枚举。
  6. 使用 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