有数Excel创建报告技能

功能

该技能允许用户通过上传本地 Excel 文件，大模型会首先读取并分析该文件的数据概况，主动启发用户产生分析思路。在用户确认具体的自然语言思路后，技能将调用知数平台（有数 BI）的接口，自动生成报告并返回相应的看板 URL。

依赖环境

• Node.js 20+
• 需要网络连接访问有数平台API
• 拥有读取 Excel 文件的能力（如利用 Python 的 pandas 库或 Node.js 的 xlsx 库）

使用场景

• 用户拥有一份本地 Excel 数据，希望快速将其导入有数 BI 并根据自然语言思路（如“分析各地区的销售趋势”）一键生成分析看板，但在开始前需要大模型协助探索分析方向。

技能执行流程（核心必读）

当用户触发此技能时，必须严格按照以下多轮对话步骤执行，不得省略任何一步：

阶段一：数据预览与思路启发（互动阶段）

1. 获取路径：获取用户提供的 Excel 文件的绝对路径 (filePath)。
2. 读取数据：作为大模型，你需要先通过内置工具（例如编写 Python 脚本使用 pandas 读取前5行，或使用 Node.js 的 xlsx 模块）读取该 Excel 文件的第一页数据和表头，了解数据的基本结构与业务含义。
3. 数据格式校验：必须判断该数据是否为标准的二维表格数据（即第一行为表头，且无合并单元格、无复杂嵌套或过多空行）。如果数据格式不符合标准二维表格的要求，主动提示用户整理数据格式后再重新上传，并终止后续步骤。
4. 开启对话：对于标准的二维表格数据，向用户简要展示数据概况，并主动提出几个初步的分析方向或业务洞察问题，邀请用户一起探讨。
5. 深度交流与思路共创：与用户进行多轮对话。在对话中，充当专业的数据分析师，逐步引导用户挖掘其真实业务需求。你可以追问用户关心的核心指标、期望看到的维度对比等，协助用户将模糊的想法逐步转化为具体的分析思路。
6. 总结与等待确认：当通过对话共创出清晰、具体的分析思路后，向用户总结这段最终的分析思路（question），并必须在此停顿，等待用户明确确认后再进入下一阶段。

阶段二：调用 API 生成报告

1. 在用户确认了最终的分析思路后，提取 question。
2. 获取当前 SKILL.md 的绝对目录地址 skillFolder。
3. 重要：在调用脚本前，AI 必须主动向用户发送一条提示信息，明确告知用户：“报告生成过程可能耗时较长，请耐心等待。在此期间请勿主动重试或中断，以免造成重复上传和创建多个报告等副作用。”
4. 调用脚本（注意参数顺序：文件路径、分析思路）。脚本执行可能耗时较久，AI 自身在等待期间务必不要主动重试或重复调用。

node ${skillFolder}/scripts/index.js <filePath> "<question>"

参数说明

• filePath: 本地 Excel 文件的绝对路径。
• question: 用户的分析思路，自然语言描述（需要用双引号包裹）。

返回结果

成功时会在控制台输出生成的有数 BI 看板 URL，例如：

正在上传文件: data.xlsx 并生成分析报告...
创建成功，看板URL: https://claw-demo.youdata.163.com/...

错误处理

• 如果 Excel 文件路径不存在，会抛出错误并提示。
• 网络或接口错误会显示具体错误信息并立刻终止问答。