用途:把工程分析(PR/CI)数据转成 PostHog 的已保存洞察、仪表盘和订阅,并说明如何直接用 HogQL 查询底层数据。
主要能力:工程分析仪表盘与 MCP 工具(pull-requests、workflow-health、pr-lifecycle、engineering-analytics-broken-tests 等)以私有 HogQL 运行,界面与工具输出不暴露底层表名,端点本身无法保存为洞察或订阅。数据可经两类载体直接查询:原始仓库表 <prefix>github_pull_requests、<prefix>github_workflow_runs、<prefix>github_workflow_jobs、<prefix>github_reviews、<prefix>github_teams / <prefix>github_team_members;以及三个固定名视图 engineering_analytics_job_costs、engineering_analytics_ci_job_history、engineering_analytics_ci_failures(非物化,查询时计算,可支撑洞察与订阅)。视图存在的唯一理由是渲染产品代码逻辑(runner 成本模型、失败指纹、jobs↔runs 提交归属),代码变更时重新渲染。
使用方式:先用 engineering-analytics-sources MCP 工具发现各 GitHub 源的 id、repo 与表前缀,不要硬编码;三个视图名固定无前缀,用 repo_owner/repo_name 或 repo 过滤。写 HogQL 前先判断三个视图是否已能回答(成本、逐 job 历史与提交归属、指纹化失败行)。原始表存 GitHub 原始 JSON,需按 references/hogql-recipes.md 的基础子查询与规则处理:时间戳是字符串,先 parseDateTimeBestEffort;嵌套 JSON 为 Nullable,先 ifNull 解包;CI↔PR 按 PR 号归属而非 head SHA;默认排除 bot 与草稿;merged_at - created_at 应命名为 open_to_merge_seconds,不可称 cycle time;结论可能滞后,仅对 status='completed' 计算比率;reviews 按 pr_number 关联;作者→团队用 github_team_members 半连接,只输出团队级聚合。用 execute-sql MCP 工具或 SQL 编辑器测试后再用 insight-create 保存为 SQL 洞察,可用 dashboard-create 打包,再按 managing-subscriptions 技能创建订阅。
限制:SQL 洞察目前无法配置告警(告警需 trends 洞察),可改用定时订阅或 prompt 类 AI 订阅;flaky-test 排名、broken-tests 分类、团队 CI 健康汇总、失败日志抽稀属产品逻辑,不要用 SQL 重建,应调用相应 MCP 工具或 AI 订阅;不要自行从 runner 标签重算美元成本;ci_failures 仅 pytest 且仅失败,计数是绝对信号而非比率;estimated_cost_usd 为 NULL 表示不可计费或仍在运行,不是零;不得构建按作者排行榜或跨作者排名。