前言¶
业务数据往往先落在本地文件或外部系统导出结果里，再需要进飞书多维表格（Bitable）做协作与看板。手工粘贴行数一多就不可维护；自己写 Open API 脚本又要处理鉴权、字段类型和同步策略。下面介绍 SkillHub 上的社区 Skill feishu-bitable-import，让 Agent 在对话里按既定流程完成批量导入与同步。
这是什么¶
feishu-bitable-import（坐标 @user_c219b9fa/feishu-bitable-import，版本 1.0.0）是 SkillHub 分类 office-efficiency 下的社区来源 Skill，由发布者 user_c219b9fa 提供。定位是企业场景下的飞书多维表格数据导入：从 CSV / Excel / JSON 批量写入 Bitable，并覆盖「新建表格」与多种同步方式等常见需求。Skill 标签标明 requires_api_key=true，使用前需准备飞书侧 API 凭证，具体字段名以安装后 Skill 内 SKILL.md 为准。
官方页面：SkillHub - feishu-bitable-import
核心功能¶
以下能力均来自 SkillHub 简介，未在资料中出现的细节不展开：
- 多格式导入：支持从 CSV、Excel、JSON 批量导入到飞书多维表格。
- 字段类型推断：导入时自动推断字段类型，减少手工建列。
- 三种同步模式：增量更新、全量覆盖、仅新增，可按场景选择。
- 从本地数据建表：支持基于本地数据一键创建新的多维表格。
- 对话触发：适合在 Agent 里用自然语言发起导入；官方列出的触发语包括「导入CSV到飞书」「批量导入飞书表格」「飞书数据导入」「feishu bitable import」「创建飞书表格」「数据导入飞书」等。
安装与启用¶
通过 SkillHub CLI 安装¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（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/，Agent 可能识别不到。常用路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装本 Skill 的命令形式为（将 <skills 目录> 换成你环境对应路径）：
skillhub install @user_c219b9fa/feishu-bitable-import --dir <skills 目录>
也可先搜索再安装：
skillhub search feishu-bitable-import
skillhub install @user_c219b9fa/feishu-bitable-import --dir <skills 目录>
通过提示词让 AI 安装¶
SkillHub 页面提供的安装提示为：根据 SkillHub 安装与优先源配置，安装 @user_c219b9fa/feishu-bitable-import。
API Key¶
标签 requires_api_key=true 表示需要配置飞书开放平台相关密钥。安装完成后阅读 Skill 包内的说明，按文档填写凭证；资料中未给出具体环境变量名或配置文件路径，此处不臆造。
典型用法¶
资料未提供独立命令行示例或固定配置文件片段，典型用法是对已启用该 Skill 的 Agent 说明意图，并附上本地文件路径或数据说明。例如：
- 说明目标：导入到已有 Bitable，或从本地数据创建新表。
- 提供数据源：CSV / Excel / JSON 文件路径或结构化内容。
- 选择同步策略：增量更新、全量覆盖或仅新增（与官方简介一致）。
- 使用官方触发语之一发起任务，如「导入CSV到飞书」或「feishu bitable import」。
经过上面的步骤，Agent 应按 Skill 内流程调用飞书 API 完成导入；若字段类型或表结构有特殊要求，在对话中一并说明。
适用场景与注意¶
适合谁
- 需要把本地 CSV/Excel/JSON 批量导入飞书多维表格的团队。
- 从中台、报表或外部系统定期导出数据并同步到 Bitable 的场景。
- 希望用 Agent 对话完成导入，而不是每次手写脚本的开发者。
注意
- 社区来源（
source: community），使用前自行评估权限范围与数据合规。 - 依赖飞书 API 与有效 API Key；网络与开放平台配额限制会影响大批量导入。
- SkillHub 页面统计（截至抓取）：评分 100000，下载 882，安装 11；与个别渠道展示的下载数可能不一致，以 SkillHub 页面为准。
- 全量覆盖等模式可能改写线上数据，执行前确认表与备份策略。
结尾¶
feishu-bitable-import 把「本地文件 → 飞书多维表格」的常见路径封装成 Agent Skill，覆盖多格式导入、字段推断和三种同步模式。需要安装或查看说明时，可打开 https://www.skillhub.cn/skills/user_c219b9fa/feishu-bitable-import 或 API 入口 https://api.skillhub.cn/user_c219b9fa/feishu-bitable-import。
