weekly-business-report

每周业务报告生成器

从多个业务系统提取数据，将其综合为连贯的叙述，并生成可供高管阅读的每周报告，将原始数字转化为战略洞察。

目录

• references/configuration.md — 首次运行的设置问题、目录布局、完整的 config.yaml 和 kpi-history.json 架构。
• references/data-and-calculations.md — 各数据源的数据收集、趋势指标、目标对比、滚动平均值、异常检测、比较模式、自定义 KPI 分组、质量规则和错误处理。
• references/output-template.md — 完整的报告 Markdown 模板和详细程度。

工作流

首次运行（不存在配置）

1. 运行设置问题并创建目录布局。参见 references/configuration.md。
2. 根据 references/configuration.md 中的架构生成 config.yaml 和 templates/kpi-definitions.yaml。
3. 根据 references/configuration.md 中的架构初始化 history/kpi-history.json。

后续每次运行

1. 读取 config.yaml 和 templates/kpi-definitions.yaml。
2. 确定报告周期（上一个完整的业务周）。
3. 从每个已启用的数据源提取数据，并将快照保存到 data/{date}/。参见 references/data-and-calculations.md。
4. 计算每项 KPI：趋势指标、目标对比、滚动平均值和异常。参见 references/data-and-calculations.md。
5. 与目标值和前几周进行比较；标记异常。
6. 根据 references/output-template.md 中的模板生成报告，并针对每位接收者调整详细程度。
7. 将报告保存到 reports/{date}-weekly-report.md，并将本周的数值追加到 history/kpi-history.json。

快捷命令

• “生成本周报告” — 为最近一个完整周生成完整报告。
• “显示收入趋势” — 提供收入专项趋势分析，并包含 4-8 周的历史数据。
• “本周有哪些值得关注的问题？” — 仅输出关注事项。
• “添加 KPI [名称]” — 添加一项新的 KPI 进行跟踪（参见 references/data-and-calculations.md 中的自定义 KPI 分组）。
• “更新目标” — 修改现有 KPI 的目标值。
• “比较最近 4 周” — 并排比较最近 4 份周报。
• “年初至今摘要” — 汇总年初至今所有跟踪的 KPI。

每次运行都要应用 references/data-and-calculations.md 中的报告质量规则和错误处理。