SuperAPI AI 工具集

weekly-business-report

数据与分析

查看项目

更新于 10-16 02:38

技能介绍

用途:自动生成周度业务 KPI 报告,从多个业务系统拉取数据,合成为连贯叙述,输出可直接交付管理层的周报,把原始数据转化为趋势判断与目标对比。

主要能力:支持多来源数据采集(含 Supabase 分析、CRM、财务表格、邮件指标等);计算趋势指标、目标对比、滚动平均与异常检测;支持对比模式、自定义 KPI 组、数据质量规则与错误处理;报告含多种细节层级,可按收件人调整详略。

使用方式:首次运行需回答配置问题并创建目录结构,生成 config.yaml、templates/kpi-definitions.yaml,初始化 history/kpi-history.json;之后每次运行读取配置与 KPI 定义,确定报告周期(上一个完整业务周),从已启用来源拉取数据快照到 data/{date}/,计算全部 KPI 并对比目标与往周、标记异常,最后按模板生成报告保存到 reports/{date}-weekly-report.md,并将本周数值追加到 history/kpi-history.json。

快捷指令:“Generate this week's report”生成最近完整一周的完整报告;“Show me revenue trends”输出含 4–8 周历史的收入趋势分析;“What are the concerns this week?”仅输出关注项;“Add KPI [name]”新增 KPI;“Update targets”修改已有 KPI 目标值;“Compare last 4 weeks”对比最近 4 周;“YTD summary”输出年初至今汇总。

参考文档:references/configuration.md(首次配置与目录、config.yaml、kpi-history.json 结构)、references/data-and-calculations.md(各来源采集、趋势、目标对比、滚动平均、异常、对比模式、自定义 KPI 组、质量规则与错误处理)、references/output-template.md(报告 Markdown 模板与细节层级)。

限制:具体数据源字段、连接与鉴权方式、费率与价格、运行平台要求,以及实际输出效果均暂未提供;每次运行需遵循上述质量规则与错误处理。