SuperAPI AI 工具集

prodinfos-cli

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:在编码智能体工作流中,通过 Prodinfos CLI 以确定性、有界的方式查询产品分析数据、执行导出并校验 SDK 埋点是否正确落地。适用于查询 Prodinfos 项目的产品分析、验证 SDK instrumentation、以及在不写原始 SQL 的前提下回答引导、付费墙、调查、留存或导出类问题。

主要能力:优先使用高层查询命令族,包括 funnel、conversion-after、paths-after、retention、survey、timeseries、breakdown、generic;仅在用户明确需要原始 CSV 时使用 events export。CLI 与仪表盘查询同一 API,不存在 CLI 专属分析源;序列敏感与队列敏感查询仍基于原始事件,聚合读取仅在 API 报告该计划形态时可接受。runtimeEnv 由 SDK 自动附加,不应虚构独立模式字段。

使用方式:一次性设置首选 npm i -g @prodinfos/cli 后执行 prodinfos setup --token <readonly_token>;也可用 prodinfos login --readonly-token <readonly_token> 或 prodinfos login --clerk-jwt <clerk_jwt>。自动化或智能体推理优先 --format json,简短人工摘要用 --format text;精确值用 timeseries --viz table,趋势扫描用 --viz chart 或 svg。SDK 上线或查询变更后可用稳定读取校验,例如 prodinfos schema events --project <id> --limit 200、prodinfos goal-completion --project <id> --start onboarding:start --complete onboarding:complete --last 30d、prodinfos get onboarding-journey --project <id> --last 30d --format text。

限制与安全规则:始终用 --project <id> 限定项目,用 --last 或显式 since/until 限定时间;优先高层查询端点而非原始导出;分组与结果集保持有界;默认只读发布数据;不生成原始 SQL,不请求无界原始事件转储,除非用户明确要求否则不包含调试数据。若当前 CLI 能力无法完成请求,应说明能力缺失,不要用不等价命令冒充,并可通过 PRODINFOS_CLI_ENABLE_WRITE_COMMANDS=true prodinfos feedback submit 提交可复现的缺口报告。支持版本:技能包 1.0.0,目标包 @prodinfos/cli,范围 ^0.1.0;若未来 CLI 主版本不兼容地更改命令或标志,应拆分到同级技能如 prodinfos-cli-v1。其他细节暂未提供。