SuperAPI AI 工具集

analyzing-insights-across-teams

数据与分析

查看项目

更新于 10-16 03:45

技能介绍

用途:当分析问题涉及当前项目之外的团队或项目时,system.* 实体表(如 system.insights)只覆盖当前项目,此时可改为查询已同步进 dogfood 项目数据仓库的生产 Postgres 表,用 posthog:execute-sql 做跨团队实体元数据分析。该技能为仓库本地(.agents/skills/),仅适用于在该仓库工作的智能体,不得移入对外打包分发。

可用同步表:US 环境为 postgres.posthog_dashboarditem、postgres.posthog_dashboard、postgres.posthog_team;EU 环境对应 eu_postgres_posthog_dashboarditem 等。下划线别名指向同一同步数据。这些是 Django 表副本,行覆盖所有团队,team_id 为范围列。

使用方式:先用 system.information_schema.tables 查询 table_type = 'data_warehouse' 且表名含 postgres 的表,确认还有哪些同步表;再用 system.information_schema.columns 确认列结构(随 Django 模型变化)。查询时按 team_id 过滤或分组,需要团队名称时可将 postgres.posthog_team 按 id = team_id 关联,但仅限内部界面。示例逻辑为按 team_id 统计近 30 天创建的 insights 数量并排序。注意这是周期性副本,存在同步延迟,适合分析而非实时状态。

限制:表中含客户数据(团队名、insight 名称、描述、查询),不得将团队名、insight 标题等行级元数据放入公开界面,如 PR 标题/描述、提交信息、issue、代码注释或截图;公开文案最多只能使用不含名称的聚合与 team_id 级数字,具名结果仅留在私密对话、内部文档或需鉴权链接。访问受内部 dogfood 项目成员身份限制;若查询报权限错误,应报告并停止,不得另寻跨团队数据途径。跨团队事件/分析数据请改用 querying-production-databases-via-metabase 技能。