表格使用技能:以電子表格爲輸入輸出的 Agent Skill

前言

在 Cursor、Claude Code 等環境裏處理表格時,常見做法是臨時寫一段 Python 或讓模型「口頭描述」改表結構。前者交付物往往是腳本而不是 .xlsx;後者又容易漏掉格式、公式或髒數據行。若任務明確要求打開、修改或產出 .xlsx、.csv 等文件,需要一套能約束觸發條件與交付形態的 Skill 說明。

下面介紹 SkillHub 社區 Skill「表格使用技能」(座標 @user_90d58900/excel01),用於在 Agent 側統一「何時啓用、做什麼、不做什麼」。

這是什麼

「表格使用技能」是遵循通用 SKILL.md 格式的社區 Skill(來源:community,發佈者 user_90d58900,版本 1.0.0,分類 office-efficiency)。它不替代 Excel 本身,而是告訴 Agent:只要電子表格文件是主要輸入或主要輸出,就應加載該 Skill 並按其中規則執行。

官方頁面與 API 入口:

  • https://www.skillhub.cn/skills/user_90d58900/excel01
  • https://api.skillhub.cn/user_90d58900/excel01

標籤標明 requires_api_key=false,安裝後無需額外 API Key。SkillHub 頁面顯示評分 100000,下載 11516 次,安裝 228 次(數據以 SkillHub 展示爲準)。

核心功能

以下能力均來自官方 Skill 簡介,概括爲可操作範圍:

  1. 讀寫與修復現有表格:支持 .xlsx、.xlsm、.csv、.tsv。包括增列、計算公式、格式化、製圖、清洗雜亂數據等。
  2. 新建表格:從零創建,或從其他數據源生成電子表格。
  3. 格式互轉:在常見表格文件格式之間轉換。
  4. 髒數據整理:處理錯行、表頭錯位、垃圾數據等,輸出爲規範電子表格。
  5. 觸發條件:用戶提到文件名或路徑(例如「下載文件夾裏的那個 xlsx」)且要對文件做處理或從數據產出表格時,應觸發本 Skill。

明確不觸發的情形(交付物不是電子表格文件時不要用本 Skill):

  • 主要交付物是 Word、HTML 報告、獨立 Python 腳本、數據庫流水線,或 Google Sheets API 集成——即使中間涉及表格數據。

安裝與啓用

SkillHub 推薦讓 Agent 按官方安裝文檔操作,或直接對 AI 發送安裝提示詞。安裝說明引用:https://skillhub.cn/install/skillhub.md ,目標座標爲 @user_90d58900/excel01。

1、檢查或安裝 SkillHub CLI

先確認本機是否已有 skillhub:

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

2、安裝到當前 Agent 的 skills 目錄

安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄,否則默認落在 ./skills/ 且 Agent 可能無法加載。

skillhub install @user_90d58900/excel01 --dir <你的 skills 目錄>

常用路徑(來自 SkillHub 安裝文檔):

客戶端 skills 目錄
Cursor ~/.cursor/skills/
Claude Code ~/.claude/skills/
Codex ~/.codex/skills/ 或項目下 .agents/skills/
Windsurf ~/.codeium/windsurf/skills/ 或項目 .windsurf/skills/

以 Cursor 爲例:

skillhub install @user_90d58900/excel01 --dir ~/.cursor/skills/

也可將下列提示詞發給 Agent,由其按 skillhub.md 完成安裝:

請根據 https://skillhub.cn/install/skillhub.md,安裝 `@user_90d58900/excel01`。

安裝後若 Agent 未立即識別新 Skill,按所用客戶端說明重啓或刷新 skills 配置。

典型用法

官方未提供單獨示例倉庫;用法體現在 觸發描述 + 交付物類型 上。下列表述與 Skill 簡介一致,便於復現「何時應加載本 Skill」:

  1. 編輯現有文件:「請打開 report.xlsx,增加一列利潤率並按百分比格式顯示。」——輸入、輸出均爲電子表格。
  2. 清洗 CSV:「data.tsv 表頭在第 3 行,前面有兩行說明文字,請整理成標準表並保存爲 .xlsx。」——屬於 messy tabular data 整理。
  3. 新建與轉換:「根據這份 JSON 列表生成 .xlsx。」或「把 export.csv 轉成 .xlsm 並保留宏工作簿結構需求時選用 .xlsm。」
  4. 不應觸發:「寫一份 HTML 數據分析報告」或「寫一個 pandas 腳本以後我自己跑」——交付物不是表格文件,應使用其他 Skill 或普通對話,而非本 Skill。

經過上面的步驟安裝後,在對話中直接引用文件路徑或格式即可,Agent 應依據 Skill 規則選擇表格處理流程而非偏離交付形態。

適用場景與注意

適合誰

  • 日常用 Agent 改表、做表、洗表,且希望最終文件是 .xlsx / .csv 等格式的產品、運營、分析崗位。
  • 已在 Cursor、Claude Code、Codex 等支持 Skill 的環境工作,並願意用 SkillHub 管理技能包。

限制與注意

  • 本 Skill 約束的是 Agent 行爲邊界,不保證替代專業 ETL 或在線協作(如 Google Sheets API);後者在官方說明中屬於不應觸發的範圍。
  • 大文件、複雜宏(.xlsm)或極端髒數據仍需人工抽檢結果;Skill 未承諾具體庫或運行時版本。
  • 安裝路徑錯誤是常見坑:務必 --dir 指向當前 Agent 的 skills 目錄。

結尾

「表格使用技能」把「表格文件爲主輸入/輸出」這一類任務從泛泛的編碼或文檔生成裏拆開,減少交付物跑偏。若你主要通過 SkillHub 管理 Agent 能力,可從官方頁查看說明並安裝 @user_90d58900/excel01:

https://www.skillhub.cn/skills/user_90d58900/excel01

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜