agent-statsig

用途：通过 Statsig Console API 管理功能开关（feature gates）、动态配置（dynamic configs）、实验（experiments）、分群（segments）与标签（tags），用于功能开关、灰度发布、A/B 测试和定向规则的查看与修改。\n\n主要能力：提供 gate、config、experiment、segment、tag 等子命令，支持列出、获取、创建、启用/禁用、设置灰度百分比、增删改移动规则、设置动态配置 schema 与默认值，以及启动、发布、放弃实验；规则按自上而下顺序求值，首个匹配规则生效，规则内条件为 AND、规则间为 OR；支持 25 种内置条件类型（如 email、user_id、country、custom_field、public、passes_segment、passes_gate），并可按环境用 --env 限定规则。\n\n使用方式：遵循先读后写，先运行 gate get、rule list、criteria 等命令了解现状；创建实体时可先用 tag list 检查标签、再以 --tag 应用。动态配置写入支持 --dry-run 让 API 校验而不持久化。get 支持多个 id，默认输出 NDJSON，可用 --format json 或 yaml 聚合；不可解析的 id 输出 @unresolved 并以 0 退出。调试可加 -d/--debug 打印请求。各实体可通过 gate usage、config usage 等查看完整命令说明。\n\n限制与安全：Console API key 属服务器机密，禁止粘贴到聊天或 --console-key 参数中；推荐用 --form 交互式输入，或在无界面环境通过管道 stdin 传入（printf '%s' "$CONSOLE_KEY" | agent-statsig project add <alias> --client-key <clientkey>）。可发布的 Client SDK key 才可放在 --client-key。错误以 JSON 输出到 stderr 并带分类：fixable_by 为 agent、human 或 retry。设置 schema 时若现有值不符合会被阻止，需先修正或加 --force。价格、平台等信息暂未提供。