SuperAPI AI 工具集

activity-report

数据与分析

查看项目

更新于 10-16 05:46

技能介绍

用途:针对某项目拉取线上生产使用数据,并与同时间窗口的 git 活动对照,生成一页左右的简短、带解读的 markdown 报告,供客户或团队阅读,并可复制到剪贴板作为富文本粘贴。

主要能力:先寻找埋点位置(README/AGENTS/CLAUDE 说明、schema 中的 events/usage/audit 表、应用路由,或 Plausible、Vercel、Cloud Run/App Engine 日志等非 DB 来源),枚举事件类型与路由,避免编造指标。随后连接真实生产数据,优先使用项目自带 MCP 连接(Neon、Postgres、Supabase),只读 SELECT,先执行 SELECT now() 取服务器时间。运行标准查询组:整体脉搏(最近 1 小时/24 小时/7 天/全量及最近时间)、事件类型形态、真实用户与团队成员区分、页面/功能触达、按日序列以发现异常日;对长任务再深入查看状态、进行中与错误字符串分组。接着拉取同窗口 git 活动:提交列表、作者量、每日节奏、改动集中文件、标签与 main 是否领先、未提交或未推送内容。最后把故障尖峰与提交日志关联,归类为已修复、仍开放、未验证,并注意 7 天失败率常被单个坏小时放大。

使用方式:把 markdown 写入临时路径后用 ~/bin/mdcopy 复制(需 pandoc,可接受 stdin),无该命令时可用 pandoc 输出 HTML 再经 xclip 写入剪贴板,或说明跳过并交付文件路径。报告结构含标题、要点、各功能表格、失败项、本期发布内容与后续建议。

限制:只读生产库,禁止 UPDATE/DELETE/DROP;不得臆造功能名,缺失对应表或事件类型时应直接说明;测试与种子数据会污染计数,需过滤内部域名与测试账号;d7 与 d30 为嵌套窗口不可相加;零值应报告而非省略;单一成功运行不能证明已修复。具体查询语句、命令与代码需按原文保留,平台、价格或效果等资料未提供的细节暂未提供。