初始化设置

首次使用时，请阅读 setup.md 文件以了解集成指南。若目录 ~/mobile-app-analytics/ 尚未存在，请手动创建。

适用场景

当用户需要追踪、分析或优化移动应用性能指标时使用。本 Agent 可处理 Firebase Analytics 查询、App Store Connect 数据、Play Console 报告、留存率分析、漏斗调试以及用户群组（cohort）对比等任务。

架构设计

所有记忆数据存储于 ~/mobile-app-analytics/ 目录下。具体初始化方式请参阅 memory-template.md。

~/mobile-app-analytics/
├── memory.md          # 已追踪的应用、目标、告警配置
├── apps/              # 各应用专属的分析配置
│   └── {app-name}.md  # 每个应用的事件定义、漏斗路径、核心指标（KPI）
└── benchmarks.md      # 行业基准参考数据

快速查阅表

核心规则

1. 平台识别

根据上下文自动识别应用所面向的平台：

• 仅 iOS → 聚焦 App Store Connect + Firebase
• 仅 Android → 聚焦 Play Console + Firebase
• 跨平台 → 同时覆盖两个应用商店 + 统一 Firebase 配置

2. 指标优先级层级

始终按以下顺序优先关注指标：

1. 收入类指标（LTV、ARPU、转化率）——直接决定商业可持续性
2. 留存类指标（D1、D7、D30）——衡量长期成功的关键
3. 参与度指标（DAU/MAU、会话时长）——领先性行为信号
4. 获客类指标（安装量、来源渠道）——驱动增长的核心杠杆

3. 用户群组（Cohort）优先分析法

禁止单独报告聚合总数。必须始终按以下维度进行分层：

• 安装群组（用户加入时间）
• 获客来源（自然流量、付费渠道、推荐渠道）
• 用户等级（免费版、试用版、付费版）
• 平台类型（iOS vs Android）

4. 告警阈值

主动识别并标记异常情况：

5. 数据时效性

各平台数据延迟情况如下：

6. 隐私合规要求

• 自定义事件中严禁记录任何 PII（个人身份信息）
• 严格遵守 ATT（iOS 应用跟踪透明度）及用户授权要求
• 用户属性：允许记录人口统计类信息（如年龄区间、地区），禁止记录个人标识符（如邮箱、手机号、设备 ID）
• GDPR 合规：支持响应用户的数据删除请求

7. 事件命名规范

确保跨平台事件命名风格统一：

{动词}_{名词}[_{修饰词}]

示例：
- view_screen_home
- tap_button_subscribe  
- complete_purchase_annual
- start_onboarding_step1

常见误区

• 沉迷虚荣指标（Vanity metrics） → 总下载量毫无意义；应聚焦活跃用户数与留存率
• 忽视平台差异 → iOS 用户 LTV 通常比 Android 高出 20–30%；切勿盲目合并数据
• 归因窗口设置错误 → 7 天归因窗口会遗漏大量订阅转化；订阅类业务建议采用 30 天窗口
• 幸存者偏差（Survivorship bias） → 仅分析当前活跃用户，将无法理解流失用户的退出原因
• 时区不一致 → Firebase 默认使用 UTC；App Store Connect 使用您在后台配置的本地时区

外部端点

除此之外，不向任何其他外部服务发送数据。

安全与隐私

离开您本地设备的数据：

• 当您提供凭据后，向 Firebase / Apple / Google 的 API 发起的分析查询请求

保留在本地的数据：

• 保存在 ~/mobile-app-analytics/ 中的已追踪应用列表、目标设定与告警配置
• 行业基准对比结果与备注说明

本能力（skill）明确不执行以下操作：

• 不存储任何凭据（请使用各平台标准的凭据管理方式）
• 不访问 ~/mobile-app-analytics/ 目录之外的任何文件
• 不向未声明的端点发起网络请求

能力边界

本能力（skill）仅支持以下功能：

• 提供主流移动应用分析平台（Firebase、App Store Connect、Play Console）的使用指导
• 将您的应用配置持久化存储至 ~/mobile-app-analytics/
• 在您提供有效凭据的前提下，调用 Firebase、App Store Connect 和 Play Console 的公开 API 获取数据

本能力（skill）绝不会执行以下操作：

• 将凭据写入文件（请通过环境变量等方式安全传递）
• 访问 ~/mobile-app-analytics/ 目录之外的任意文件
• 向未在文档中声明的端点发起请求
• 修改全局 agent 记忆或其他技能（skill）的状态

相关技能

若用户确认安装，可使用命令：clawhub install

• app-store-connect —— iOS App Store 运营管理
• flutter —— 跨平台应用开发
• saas —— SaaS 业务指标与增长方法论

反馈与更新

• 若该能力对您有帮助，请执行：clawhub star mobile-app-analytics
• 保持最新版本，请定期执行：clawhub sync