report-pack

报表包

将两个 Skill 串联起来，让业主的周期性数字自动送达，并附带足够的上下文以便采取行动：report-builder 负责报表包本身，business-pulse 负责周边情况。

业主脑子里通常已经有想要的报表，缺的是它在周一自动送到手上，而不用他们去催。这就是这里的全部任务。

第 1 步 — 报表包（report-builder）

调用 report-builder。它负责规格说明、数据拉取、计算和工作簿，此处不要重复实现这些内容。

• 输入： 业主对报表包的描述，或已保存报表包的名称。
• 输出： 聊天摘要、一个 XLSX 工作簿，以及一份已保存的定义。

report-builder 会先检查已保存的定义。如果报表包已存在，它会直接重新运行，无需再次询问业主。如果不存在，它会构建规格说明并请业主确认一次。

关卡 — 规格确认。 全新的报表包在运行前需要业主确认一次。已有保存定义的报表包则不需要。让人重新描述他上个月已经定义过的报表，是让这个命令显得失灵最快的办法。

第 2 步 — 上下文快照（business-pulse）

报表包运行后，针对同一时段调用 business-pulse。

• 输入： 报表包所覆盖的时段。
• 输出： 现金、销售趋势、销售管道、观察清单，以及需要关注的一件事。

脉搏快照是上下文，而不是第二份报表。它回答报表包总会引出的问题：数字变了，但业务是否正常？

此处无关卡。 两个步骤都是只读的。不会发送、发布或写入账本，因此两步之间没有需要业主批准的内容。

第 3 步 — 合并为一次交付

一条消息，顺序如下：报表包摘要，然后是两到三行的脉搏快照，最后是工作簿。

Okonkwo Mechanical 的 Ray Okonkwo 收到他的周一报表包：按班组划分的营收（与去年对比）、应收账款账龄，以及人工成本占营收的百分比。其下方是：现金 61,400 美元，两张发票逾期超过 60 天，还有一辆货车仍在维修。他用九十秒读完两部分，就知道周一要做什么。

切勿发送两份独立的交付物。报表包和脉搏快照分开到达，就是两份需要阅读的内容；合在一起，才是一份简报。

请使用标准的 artifact 样式（../../shared/artifact-style.md）将此简报渲染为一个 HTML artifact。它是对聊天摘要和工作簿的补充，绝不是替代。报表包的核心指标使用统计卡片，其对比信息作为上下文行显示；分组的报表行使用表格，并采用等宽数字（tabular-nums）；脉搏快照的上下文放在下方独立的面板中，其观察清单条目带有状态标签（warn 或 critical）；数据来源异常时，在页脚用一行低调的文字注明来源名称。

第 4 步 — 设置周期，只问一次

在业主觉得某次运行有用之后，才提供一次排期选项。 不要更早提出——在没人看过的报表包上提出周期，就是在推销订阅。

直接询问："要每周一早上都发送吗？"如果业主同意，则将周期与报表定义一起保存到 report-builder 中，并用一行确认："已保存。将于每周一早上运行。"

之后就要遵守这一设置。每次定时运行都重复第 1 至第 3 步，不提任何问题，不再次确认，也不再提供周期选项。定时报表如果还要向业主提问，就已经不再是定时的了。

如果业主拒绝或不予回应，就放弃此事，并且不再询问。

仅在交互式运行时（绝不在定时运行时）结束，用一行说明已交付的内容，然后给出最相关的下一步，以及最多两个相近的选项：

• 如果报表包引出了现金问题："现金预测"会运行 cash-flow-snapshot。
• 如果脉搏快照标记了逾期应收账款："谁欠我钱"会运行 invoice-chase。
• 要更改报表包的跟踪内容："帮我做个报表"会运行 report-builder。

最多提供三个选项。本次会话中业主已拒绝的选项，不要再次提出。

第 5 步：遇到数据不全的运行时照常执行

定时运行无论每个连接器是否正常都会进行。如果某个数据源不可用，report-builder 会将对应指标标记为“n/a”并注明数据源名称；报告包依然照常交付。

绝不要因为数据不完整而跳过定时交付。 一份有一处缺口并附带说明的报告包是有用的。若周一毫无动静，用户就会以为插件坏了，从而不再期待它。

如果负责人完全没有连接任何连接器，那么 CSV 路径就是报告包的来源。请一次性索要导出文件，基于该文件运行完全相同的报告，并保持既定节奏。

不应做的事

• 不要就已保存的报告包重新询问负责人。 每次运行前都先检查已保存的定义。
• 不要在此处重新构建报告逻辑。 规格、计算和工作簿均由 report-builder 负责。
• 不要重新计算 pulse 数据。 这些数据由 business-pulse 负责，以确保只有一套数字。
• 不要两次提出节奏设置。 在一次有用的运行之后提出一次，此后不再重复。
• 定时运行时不要提出任何问题。 定时运行意味着结果在负责人不参与的情况下送达。
• 不要因为某个连接器失败而跳过运行。 应照常交付，并写明缺口。
• 不要将报告包和 pulse 拆成两条消息发送。 应合并为一份简报，一次阅读完成。

使用未列出的工具

本技能中列出的连接器只是经过测试的路径，并非唯一选择。如果负责人希望该流程使用尚未连接或未列出的工具，可以提供 build-connector。它会先检查连接器目录，否则通过 Zapier 进行连接，绝不会直接调用原始 API 手动构建。连接建立后，该工具将与其他可选连接器一样加入本技能，并遵循同样的审批关卡。