核心用法
RevenueCat Skill 提供完整的订阅经济数据分析与客户管理能力。用户通过设置 RC_API_KEY 环境变量获取单一项目的访问权限，随后可调用封装脚本 {baseDir}/scripts/rc-api 访问 RevenueCat REST API v2。
主要功能涵盖：
- 订阅指标查询：MRR、churn、活跃用户等核心 SaaS 指标
- 客户数据管理：CRUD 操作、属性管理、订阅状态查询、退款处理
- 产品与应用配置：Offerings、Entitlements、Products 的配置与测试
- 文档检索：支持本地 API 参考文件加载及远程官方文档搜索（llms.txt + sitemap 索引）
API 按领域模块化组织，包括 Customers、Subscriptions、Metrics、Paywalls、Integrations 等 12 个域，按需加载避免上下文膨胀。
显著优点
1. 官方能力直接暴露：封装 RevenueCat 官方 v2 API，数据权威性高
2. 模块化引用设计：分域文档按需加载，平衡完整性与上下文效率
3. 双轨文档支持：本地结构化参考 + 远程实时文档，兼顾离线可用与信息时效
4. 商业化场景聚焦：专为订阅制应用设计，指标口径与行业标准对齐
潜在缺点与局限性
- 单项目限制：一个 API Key 仅绑定单一项目，跨项目分析需多 Key 切换
- 依赖外部凭证：必须预先配置 RC_API_KEY，无内置 OAuth 流程
- 只读为主：虽有 cancel/refund 等操作端点，但高危操作需二次确认机制
- 环境耦合：依赖 curl 与特定目录结构，迁移性一般
适合人群
- 运营/增长团队：监控订阅健康度、分析 churn 趋势
- 产品经理：调试定价实验、验证 paywall 配置
- 开发者：集成 RevenueCat SDK 时的后端数据验证与调试
常规风险
- API Key 泄露风险：v2 Key 拥有项目级权限，需严格保管
- 误操作风险：refund/cancel 端点直接关联真实用户资金，生产环境慎用
- 速率限制：未明确披露限流阈值，高频批量查询可能触发限制