37g 数据分析与运营 Agent

用户自然语言问题
      │
      ▼
Agent 理解意图，生成 SQL
      │
      ▼
安全检查层
  ├─→ 只允许 SELECT 语句
  ├─→ 禁止 DROP/DELETE/UPDATE/INSERT
  ├─→ 查询白名单校验（只允许访问指定表）
  ├─→ 结果行数限制（最多 1000 行）
  └─→ 查询超时限制（最多 30 秒）
      │
      ▼
只读数据库用户执行 SQL
      │
      ▼
格式化结果 → 回复用户

-- 创建只读用户
CREATE USER agent_readonly WITH PASSWORD 'secure_password_here';
 
-- 只授予 SELECT 权限
GRANT CONNECT ON DATABASE hackquest TO agent_readonly;
GRANT USAGE ON SCHEMA public TO agent_readonly;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO agent_readonly;
 
-- 未来新建的表也自动授予 SELECT
ALTER DEFAULT PRIVILEGES IN SCHEMA public
  GRANT SELECT ON TABLES TO agent_readonly;
 
-- 设置查询超时（30秒）
ALTER USER agent_readonly SET statement_timeout = '30s';
 
-- 设置最大连接数
ALTER USER agent_readonly CONNECTION LIMIT 5;

# analytics-sql-query
 
根据用户的自然语言问题，生成并执行 SQL 查询，返回格式化的数据结果。
 
## 触发条件
用户消息包含"查一下"、"数据"、"多少"、"统计"、"分析"等数据查询相关词汇。
 
## 执行步骤
1. 理解用户的数据查询意图
2. 从记忆中读取数据库 Schema 信息（表结构和字段说明）
3. 生成 SQL 查询语句
4. 安全检查：
   - 确认是 SELECT 语句
   - 确认只访问白名单中的表
   - 添加 LIMIT 1000
5. 通过 PostgreSQL MCP 执行查询
6. 将查询结果格式化为表格或摘要
7. 如果结果需要解读，附加数据洞察
 
## 安全规则
- 只生成 SELECT 语句，禁止任何写操作
- 只访问白名单中的表
- 涉及用户 email 时自动脱敏（只显示 @后的域名）
- 查询结果最多返回 20 行，超过时只返回统计摘要
- 禁止查询单个用户的详细信息
 
## 输出格式
📊 查询结果：{query_description}
 
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 值  | 值  | 值  |
 
💡 数据洞察：{insight}
 
SQL（供参考）：
```sql
{generated_sql}

---

## 2. Google Analytics 集成

### 2.1 GA4 API 配置

```json
{
  "ga4": {
    "propertyId": "properties/123456789",
    "credentials": {
      "type": "service_account",
      "project_id": "hackquest-analytics",
      "private_key_id": "key_id_here",
      "client_email": "agent@hackquest-analytics.iam.gserviceaccount.com"
    }
  }
}

# analytics-ga-report
 
查询 Google Analytics 数据，返回网站流量和用户行为指标。
 
## 触发条件
用户消息包含"流量"、"访问量"、"PV"、"UV"、"转化率"、"GA 数据"。
 
## 执行步骤
1. 识别用户想查询的指标和时间范围
2. 构建 GA4 Data API 请求
3. 执行查询并获取结果
4. 格式化为易读的报表
5. 附加同比/环比分析
 
## 支持的指标
| 指标 | GA4 API 字段 | 说明 |
|------|-------------|------|
| 活跃用户 | activeUsers | DAU/WAU/MAU |
| 页面浏览 | screenPageViews | PV |
| 会话数 | sessions | 访问次数 |
| 平均会话时长 | averageSessionDuration | 用户停留时间 |
| 跳出率 | bounceRate | 单页访问比例 |
| 新用户占比 | newUsers / totalUsers | 拉新效果 |
| 转化率 | conversions / sessions | 注册/付费转化 |
 
## 支持的维度
- 时间：日/周/月
- 来源：organic/paid/social/direct/referral
- 地区：国家/城市
- 设备：desktop/mobile/tablet
- 页面：landing page / 课程页面
 
## 输出格式
📈 GA 数据报告：{metric_name}（{date_range}）
 
| 维度 | 指标值 | 环比 |
|------|--------|------|
 
💡 洞察：{insight}
 
## 示例
**用户**: 上周的网站流量怎么样？
**Agent**:
📈 GA 数据报告：网站流量概览（2026-07-07 ~ 2026-07-13）
 
| 指标 | 本周 | 上周 | 环比 |
|------|------|------|------|
| 活跃用户 | 45,200 | 42,800 | +5.6% |
| 页面浏览 | 128,500 | 121,000 | +6.2% |
| 平均会话时长 | 4m 32s | 4m 15s | +6.7% |
| 注册转化率 | 3.2% | 2.9% | +0.3pp |
 
💡 洞察：上周流量整体上涨，主要增长来自 organic search（+12%），Solana 相关课程页面贡献了 35% 的新增流量。
 
## 权限要求
- Google Analytics Data API 读取权限
- 飞书消息发送权限
 
## 数据缓存
- 相同查询 1 小时内返回缓存结果
- 缓存存储在 OpenClaw 记忆系统中

# analytics-weekly-report
 
每周自动生成运营周报，汇总关键指标并推送到飞书群。
 
## 触发条件
- 定时触发：每周一 09:00
- 手动触发：用户消息包含"运营周报"、"生成周报"
 
## 执行步骤
1. 查询 GA4 上周流量数据（活跃用户、PV、转化率）
2. 查询 PostgreSQL 上周业务数据：
   - 新增注册用户数
   - 课程完成数
   - Hackathon 参与人数
   - 付费转化数据
3. 查询上周需求和缺陷数据（从同步的多维表格数据）
4. 计算环比变化
5. 生成周报文档
6. 推送到运营群和管理层群
 
## 周报模板
 
📊 HackQuest 运营周报（{start_date} ~ {end_date}）
 
### 一、核心指标
| 指标 | 本周 | 上周 | 环比 | 目标 | 达成率 |
|------|------|------|------|------|--------|
| 活跃用户 | | | | | |
| 新增注册 | | | | | |
| 课程完成 | | | | | |
| 付费转化 | | | | | |
 
### 二、流量分析
- 来源分布：organic / paid / social / direct
- Top 5 热门页面
- 地区分布 Top 5
 
### 三、产品进展
- 本周上线需求：{count} 个
- 本周修复缺陷：{count} 个
- 当前迭代进度：{completion_rate}%
 
### 四、关键洞察
（基于数据分析的 2-3 条洞察）
 
### 五、下周重点
（基于数据趋势的建议）
 
## 权限要求
- Google Analytics Data API
- PostgreSQL MCP（只读）
- 飞书消息发送权限

# growth-strategy
 
基于数据分析结果和历史策略效果，生成可执行的增长策略建议。
 
## 触发条件
用户消息包含"增长策略"、"怎么提升"、"如何增长"、"运营建议"。
 
## 执行步骤
1. 查询最近 30 天的核心指标趋势
2. 从记忆中读取历史策略及其效果记录
3. 从知识库检索相关的运营经验和行业案例
4. 分析数据趋势，识别增长机会和风险
5. 生成 3-5 条可执行的策略建议，每条包含：
   - 策略描述
   - 预期效果（量化）
   - 执行步骤
   - 所需资源
   - 参考依据（历史数据或行业案例）
6. 将策略建议写入记忆，后续可追踪效果
 
## 输出格式
🚀 增长策略建议（基于 {date_range} 数据分析）
 
**当前状况**：{current_metrics_summary}
 
**策略 1：{strategy_title}**
- 描述：{description}
- 预期效果：{expected_impact}
- 执行步骤：
  1. {step_1}
  2. {step_2}
- 所需资源：{resources}
- 依据：{evidence}
 
**策略 2：...**
 
## 示例
**用户**: Solana 课程上线一周了，增长策略有什么建议？
 
**Agent**:
🚀 增长策略建议（基于 Solana 课程上线首周数据）
 
**当前状况**：Solana 课程上线 7 天，累计 1,200 人开始学习，完成率 35%，主要来源为 organic search（60%）和社区推荐（25%）。
 
**策略 1：SEO 内容矩阵**
- 描述：围绕 "Solana 开发教程"、"Solana 智能合约" 等长尾关键词发布 5 篇 SEO 文章
- 预期效果：organic 流量提升 20-30%
- 执行步骤：
  1. 用 Ahrefs 分析 Solana 相关关键词搜索量
  2. 生成 5 篇 SEO 优化文章大纲
  3. 发布到博客并内链到课程页面
- 所需资源：内容团队 3 人天
- 依据：以太坊课程上线时，SEO 文章带来了 40% 的首月流量
 
**策略 2：社区 Hackathon 联动**
- 描述：举办 Solana Mini Hackathon，参赛前置条件为完成课程第一阶段
- 预期效果：课程完成率提升到 60%，新增 500+ 注册
- 执行步骤：
  1. 设计 Hackathon 主题和奖品
  2. 在 Discord/Twitter 发布活动
  3. 课程页面添加 Hackathon 入口
- 所需资源：运营 2 人天 + 奖品预算 $2,000
- 依据：上次 Move 语言 Hackathon 带来 800 新注册，课程完成率从 30% 提升到 55%
 
## 权限要求
- PostgreSQL MCP（只读）
- Google Analytics Data API
- 向量数据库（知识库检索）
- 飞书消息发送权限

# growth-competitor
 
收集和分析竞品信息，生成竞品分析报告。
 
## 触发条件
用户消息包含"竞品分析"、"竞品"、"对手"。
 
## 执行步骤
1. 从记忆中读取已知竞品列表和历史分析
2. 从知识库检索竞品相关文档
3. 根据用户指定的维度进行分析：
   - 产品功能对比
   - 课程内容对比
   - 定价策略对比
   - 用户增长趋势
4. 生成竞品分析报告
5. 提出差异化建议
 
## 输出格式
🔍 竞品分析报告
 
| 维度 | HackQuest | 竞品A | 竞品B |
|------|-----------|-------|-------|
 
💡 差异化建议：
1. {suggestion_1}
2. {suggestion_2}
 
## 权限要求
- 向量数据库（知识库检索）
- 飞书消息发送权限

# growth-content-generate
 
根据运营需求生成社区内容、教程摘要、社交媒体帖子。
 
## 触发条件
用户消息包含"写一篇"、"生成内容"、"社区帖子"、"推文"。
 
## 执行步骤
1. 理解内容需求（类型、主题、目标受众、发布平台）
2. 从知识库检索相关技术内容
3. 根据平台特点生成内容：
   - Twitter/X：280 字以内，含 hashtag
   - Discord：技术教程风格，含代码片段
   - 博客：SEO 优化的长文
4. 生成内容草稿
5. 标记为"AI 生成-待审阅"
 
## 输出格式
📝 内容草稿（{platform}）
 
{content}
 
---
⚠️ AI 生成内容，请审阅后发布。
 
## 权限要求
- 向量数据库（知识库检索）
- 飞书消息发送权限

📊 查询结果：近 30 天用户增长趋势（按周）

| 周 | 新增注册 | 活跃用户 | 注册转化率 | 环比 |
|----|---------|---------|-----------|------|
| W26 | 3,100 | 42,500 | 2.8% | — |
| W27 | 3,250 | 43,200 | 3.0% | +4.8% |
| W28 | 3,800 | 45,200 | 3.2% | +16.9% |
| W29 | 4,100 | 47,500 | 3.5% | +7.9% |

💡 数据洞察：
- W28 开始增长明显加速，与 Solana 课程上线时间吻合
- 注册转化率从 2.8% 提升到 3.5%，说明新课程有效吸引了目标用户
- 建议关注 W28-W29 新注册用户的 7 日留存率

📊 查询结果：课程完成率排名（截至 2026-07-15）

| 排名 | 课程 | 开始人数 | 完成人数 | 完成率 | 平均学习时长 |
|------|------|---------|---------|--------|------------|
| 1 | Ethereum 基础 | 15,200 | 8,360 | 55.0% | 12.5h |
| 2 | Move 语言入门 | 6,800 | 3,400 | 50.0% | 10.2h |
| 3 | Solidity 进阶 | 9,500 | 4,275 | 45.0% | 18.3h |
| 4 | Solana 开发 | 1,200 | 420 | 35.0% | 6.8h |
| 5 | ZK 证明基础 | 3,200 | 960 | 30.0% | 8.5h |

💡 数据洞察：
- Solana 课程上线仅 7 天，35% 完成率在同期对比中表现良好
- ZK 课程完成率最低（30%），可能因为难度较高，建议增加引导内容
- Ethereum 基础完成率最高，可作为新用户引导的首推课程