前言¶

业务数据落在飞书多维表格或电子表格里时，常见做法是手动导出 CSV，再在本机用 Excel 或单独起一个 Python 脚本做统计。表多、字段复杂或需要可重复的分析流程时，导出格式、权限和脚本维护都会拖慢节奏。下面介绍 SkillHub 上的社区 Skill「飞书表格数据分析」（坐标 @user_af28adda/feishu-table-analytics），把「从飞书拉数 → SQL 分析 → 可选可视化报告」收敛到 Agent 可执行的 Skill 流程里。

这是什么¶

「飞书表格数据分析」是面向 data-analysis 场景的 Agent Skill，当前版本为 1.0.0，来源标注为 community，由发布者 user_af28adda 维护。

一句话定位：飞书表格导出与数据分析工具；支持从飞书多维表格/电子表格导出数据，基于 DuckDB 执行 SQL 查询和统计分析，并可选择生成基于 Chart.js 的可视化 HTML 报告。官方说明中给出的适用时机包括：备份飞书数据、分析表格数据、生成业务洞察或可视化报表。

在 SkillHub 上，该 Skill 分类为 data-analysis，评分为 100000（平台展示值），截至页面信息可见的下载量为 1380 次；标签 requires_api_key=true，表示使用前需要配置 API 密钥类凭据。

核心功能¶

以下能力均来自 SkillHub 简介与页面描述，不展开未在官方资料中出现的接口细节。

1. 飞书数据导出：支持从飞书多维表格、电子表格拉取/导出数据，便于备份或在本地分析链路中复用。
2. DuckDB 分析：将导出数据纳入 DuckDB，用 SQL 做查询与统计分析，适合习惯用 SQL 表达指标与分组逻辑的场景。
3. 可选 HTML 报告：可按需生成带 Chart.js 图表的可视化 HTML 报告，用于快速查看趋势或分布类结果。

安装与启用¶

SkillHub 推荐的安装方式是让 Agent 按官方安装文档操作，并指定 Skill 坐标。页面给出的提示词要点如下：依据 SkillHub 安装与优先源配置，安装 @user_af28adda/feishu-table-analytics。

若本机尚未安装 SkillHub CLI，可先检查版本：

command -v skillhub && skillhub --version

未安装时，可按安装文档执行完整安装（示例为官方文档中的推荐命令）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 Skill 时，必须用 --dir 指向当前 Agent 识别的 skills 目录；装到默认 ./skills/ 可能不会被 Agent 加载。官方文档列出的常用路径包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

在 Cursor 环境下的示例命令如下（目录请按实际环境核对）：

skillhub install @user_af28adda/feishu-table-analytics --dir ~/.cursor/skills/

安装完成后，按各 Agent 要求重启或刷新 Skill 列表。因标签 requires_api_key=true，启用前需按 Skill 包内 SKILL.md 的说明配置飞书相关 API 密钥；具体环境变量名、配置文件路径以安装后的 Skill 文档为准，本文不臆造字段名。

典型用法¶

官方页面未提供逐步复制的对话示例，下面按简介归纳的可复现意图描述工作流，实际步骤由 Agent 读取 Skill 后执行。

1. 在对话中说明目标表（多维表格或电子表格）以及分析需求，例如备份、按维度汇总、或生成带图表的报告。
2. Agent 按 Skill 指引完成飞书侧认证与数据导出（依赖你已配置的 API 密钥）。
3. 在 DuckDB 上编写或生成 SQL，完成查询与统计。
4. 若需要对外展示，再选择生成 Chart.js 可视化 HTML 报告并保存或打开。

向 Agent 发起安装时，可直接使用 SkillHub 页面上的表述：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_af28adda/feishu-table-analytics`。

适用场景与注意¶

适合谁

• 已在用 Cursor、Claude Code、Codex 等支持 Skill 的客户端，希望把飞书表数据纳入 Agent 工作流的人。
• 更倾向用 SQL（DuckDB）做统计，而不是每次手工导出再拼公式的人。
• 需要偶尔产出 HTML 可视化小结，而不必先搭完整 BI 的同学。

限制与注意

• 社区来源（community），能力边界与维护节奏取决于发布者；升级可通过 skillhub 在对应 skills 目录下管理。
• 必须正确配置 API 密钥；飞书开放平台权限、表格访问范围需自行在飞书侧开通，Skill 不能绕过平台鉴权。
• DuckDB、Chart.js 等依赖由 Skill 包定义，首次使用以 SKILL.md 中的环境要求为准。
• 敏感业务数据导出到本地或 HTML 报告时，注意文件存放位置与分享范围。

结尾¶

「飞书表格数据分析」把飞书多维表格/电子表格导出、DuckDB SQL 分析和可选 Chart.js HTML 报告串成一条 Agent Skill 链路，适合备份、统计和轻量可视化报表场景。安装与坐标以 SkillHub 为准：

• Skill 页面：https://www.skillhub.cn/skills/user_af28adda/feishu-table-analytics
• API 入口：https://api.skillhub.cn/user_af28adda/feishu-table-analytics