前言¶
業務數據往往先在 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
