前言¶
业务数据往往先在 Excel 或 CSV 里维护,协作又落在飞书多维表格或电子表格上。手工复制粘贴容易漏行、字段类型对不上,批量更新也缺少统一流程。下面介绍 SkillHub 上的社区 Skill「飞书多维表格-Excel同步」,让 Agent 在对话里完成导入与导出,并自动识别链接类型、推断字段类型。
这是什么¶
「飞书多维表格-Excel同步」(坐标 @user_af28adda/excel-sync-bitable,当前版本 2.0.0)是 SkillHub 社区发布者 user_af28adda 维护的办公效率类 Skill(分类 office-efficiency)。它面向 Excel/CSV 与飞书表格(多维表格 / 电子表格)之间的双向转换:把本地表格写入飞书,或把飞书表导出为 CSV / Excel。页面标注 requires_api_key=false,不依赖额外 API Key 配置项。
官方入口:
- SkillHub 展示页:https://www.skillhub.cn/skills/user_af28adda/excel-sync-bitable
- API 坐标页:https://api.skillhub.cn/user_af28adda/excel-sync-bitable
核心功能¶
以下能力均来自 SkillHub 页面简介,未在资料中出现的细节不作延伸。
-
导入 Excel 到多维表格
支持创建新表,或同步到已有表。 -
从多维表格 / 电子表格导出
可导出为 CSV 或 Excel 格式。 -
链接与字段处理
自动识别 URL 类型;导入时智能推断字段类型,减少手工建列、改类型的工作量。
安装与启用¶
SkillHub 推荐两种方式:用自然语言让 Agent 按官方安装文档操作,或使用 skillhub CLI 指定当前 Agent 的 skills 目录。
方式一:提示 Agent 安装¶
将下面提示词发给支持 Skill 的 AI(Cursor、Claude Code 等),由 Agent 读取安装说明并完成安装:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_af28adda/excel-sync-bitable`。
方式二:SkillHub CLI¶
先确认是否已安装 CLI:
command -v skillhub && skillhub --version
未安装时可执行完整安装(含 CLI 与默认 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认装到 ./skills/ 可能不会被识别。常用路径示例:
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式:
skillhub install user_af28adda/excel-sync-bitable --dir <你的 skills 目录>
也可先搜索再安装:
skillhub search excel-sync-bitable
skillhub install user_af28adda/excel-sync-bitable --dir ~/.cursor/skills/
Cursor 与 Codex CLI、Claude Code 的差异主要在 skills 目录路径;安装流程均以 SkillHub 文档为准,核实不到的客户端特定开关不在本文展开。
典型用法¶
公开页面未给出独立脚本示例,用法是在 Agent 对话中说明数据源、目标飞书链接与方向(导入或导出)。可按下面思路组织请求,便于 Agent 调用本 Skill:
导入到飞书(新建或已有表)
- 提供本地 Excel 或 CSV 路径(或已上传文件)。
- 说明目标:创建新的多维表格数据表,或给出已有 Base / 表链接以便同步。
- 必要时补充列名映射、是否覆盖已有行等业务说明,便于 Agent 选择创建新表或写入已有表。
从飞书导出
- 提供多维表格或电子表格的可访问链接。
- 指定导出格式:CSV 或 Excel。
- 说明要导出的数据表名称(若 Base 内有多张表)。
经过上面的步骤,Agent 会按 Skill 内流程处理 URL 识别与字段类型推断;导出结果一般为本地文件路径或可供下载的文件。
适用场景与注意¶
适合谁
- 运营、项目、实施同学:周期性把 Excel 台账同步到飞书多维表格,或从飞书拉数做离线分析。
- 在 Cursor 等 IDE 里用 Agent 处理表格的同学:减少在飞书与本地之间来回复制。
使用注意
- 来源为 community,升级与行为变更以 SkillHub 上 v2.0.0 及后续版本为准。
- 大文件、复杂公式、合并单元格等 Excel 特性是否完整保留,取决于 Skill 实现与飞书 API 限制;导入前建议用小样本试跑。
- 写入已有表前确认字段名与类型与源表一致,避免推断类型与业务预期不符。
- SkillHub 统计(截至页面抓取):评分 100000,下载 39236,安装 657;数据随平台更新会变化。
结尾¶
「飞书多维表格-Excel同步」把 Excel/CSV 与飞书多维表格、电子表格之间的导入导出收拢到 Agent 工作流里,并强调 URL 识别与字段类型推断。若你的协作栈以飞书表格为主、本地仍以 Excel/CSV 编辑,可在 SkillHub 安装 @user_af28adda/excel-sync-bitable 试用。官方地址:https://www.skillhub.cn/skills/user_af28adda/excel-sync-bitable