前言¶
在 Cursor、Claude Code 等環境裏讓模型改 Excel，常見問題是格式被抹平、透視表或宏丟失，CSV 還會出現 GBK 與 UTF-8 混用導致的亂碼。手寫 openpyxl 或 pandas 腳本能跑通，但要自己處理編碼、公式重算和版式，成本不低。
下面介紹 SkillHub 社區 Skill「xlsx優化版」（座標 @user_c66b8218/xlsx007-skill，版本 1.0.0）。它用通用 SKILL.md 約束 Agent 的工作方式，面向 .xlsx、.xlsm、.csv 等表格文件的打開、創建、分析與編輯，並強調中文與 CJK 場景下的編碼與版式處理。
這是什麼¶
xlsx優化版是 SkillHub 分類 office-efficiency 下的社區 Skill，發佈者爲 user_c66b8218，標籤 requires_api_key=false（按頁面說明無需 API Key）。官方簡介將其定位爲：在儘量零格式損失的前提下，完成電子表格的創建、讀取、分析、編輯、修復與校驗，並對中文內容提供一等支持。
與「只把表讀成 DataFrame 再導出」的做法相比，它明確要求在編輯現有工作簿時保留透視表、VBA 宏、圖表、迷你圖、條件格式、命名區域等結構，並覆蓋公式重算與校驗、結果檢視和專業排版等步驟。
核心功能¶
以下能力均來自 SkillHub 頁面與 API 元數據中的官方簡介，未單獨覈實的實現細節不展開。
支持的文件與場景¶
- 文件類型：
.xlsx、.xlsm、.xltx、.csv、.tsv。 - 任務類型：新建工作簿、讀取與分析現有文件、填充與修改、修復與校驗、報表/儀表盤/預算/財務模型、透視表、任意表格形數據輸出。
中文與 CJK¶
- 文本與編碼：中文文本；UTF-8、GB18030、GBK。
- 顯示與慣例：全角字符、渲染中的 CJK 字體；中文數字與日期慣例（如 ¥、萬/億、年/月/日）。
編輯時儘量保留的結構¶
在修改已有工作簿時，簡介中列出的保留項包括：透視表、VBA 宏、圖表、sparklines、條件格式、命名區域；並包含公式重算與校驗、可視化檢視結果、應用專業格式。
觸發方式¶
當用戶提到 spreadsheet、Excel、workbook、表格、工作簿、.xlsx、.xlsm、.csv、pivot table、透視表、macro、宏、chart、圖表、financial model、財務模型、formula、公式，或任何需要產出表格數據的請求時，Agent 應按該 Skill 的指引處理。
安裝與啓用¶
SkillHub 頁面給出的安裝方式是：讓 AI 按 SkillHub 安裝與優先源配置 安裝座標 @user_c66b8218/xlsx007-skill。下面是與該文檔一致的 CLI 流程摘要。
1、檢查或安裝 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
2、安裝到當前 Agent 的 skills 目錄¶
安裝技能時必須用 --dir 指向當前 Agent 識別的 skills 目錄；默認裝到 ./skills/ 可能不會被加載。常用路徑（摘自官方安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令示例（將 <skills 目錄> 換成上面對應路徑）：
skillhub install @user_c66b8218/xlsx007-skill --dir <skills 目錄>
也可在對話中直接發送頁面提示詞：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_c66b8218/xlsx007-skill`。
經過上面的步驟，重啓或刷新 Agent 後，Skill 會隨 SKILL.md 被加載；具體是否需重啓以你所用客戶端爲準，安裝文檔提示安裝目錄錯誤時往往需要重啓才能識別。
典型用法¶
公開頁面未附帶逐步代碼示例，用法以自然語言任務 + Skill 內工作流爲主。下列表述與官方觸發詞一致，便於在已啓用 Skill 的會話中復現意圖（Agent 會按 Skill 選擇讀寫與校驗方式，而非固定單行命令）。
- 新建：「用 Excel 做一份月度預算表，含科目、金額、備註，金額用人民幣格式。」
- 讀取分析：「讀取
report.xlsx第二個 sheet，彙總各區域銷售額並標出同比爲負的行。」 - 在保留結構上修改：「在現有
model.xlsm裏增加一列公式，不要破壞透視表和已有圖表。」 - 編碼與 CSV：「這份 GBK 的
.csv轉成 UTF-8 的.xlsx，表頭中文不要亂碼。」 - 校驗與修復：「檢查工作簿裏的公式引用是否斷裂，並儘量保持條件格式不變。」
若需搜索同名或相關 Skill，可先執行：
skillhub search xlsx
再在結果中確認座標爲 @user_c66b8218/xlsx007-skill 後安裝。
適用場景與注意¶
適合誰：經常讓 Agent 處理 Excel/CSV、又在意版式與中文編碼的開發者或分析崗位；需要改財務模型、透視表報表、帶宏的 .xlsm 時，比純腳本導出更貼近官方 Skill 的設計目標。
社區與版本：來源爲 community，當前公開版本 1.0.0。SkillHub 元數據顯示評分 100000、下載 2230（統計以 SkillHub 頁面爲準，會隨時間變化）。
注意：
- 「零格式損失」是 Skill 的設計目標，複雜宏或極老格式仍建議在關鍵文件上保留備份，並在對話中說明可否接受另存爲新文件。
- 無需 API Key 僅表示 Skill 元數據中的標籤；你本地處理表格仍依賴 Agent 環境與可能安裝的 Python/Office 相關工具，以 Skill 正文與實際執行爲準。
- 安裝目錄必須對準當前客戶端的 skills 路徑，否則會出現「已 install 但 Agent 不生效」的情況。
結尾¶
xlsx優化版把表格類任務收斂到一套可重複的 Agent 指引：覆蓋多格式文件、中文編碼與慣例，並在編輯時強調保留透視表、宏、圖表等結構。若你主要在 Cursor 或 Claude Code 裏處理 Excel，可按上文安裝到對應 skills 目錄後，用表格相關自然語言直接驅動。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_c66b8218/xlsx007-skill
- API 元數據：https://api.skillhub.cn/user_c66b8218/xlsx007-skill
- 安裝說明：https://skillhub.cn/install/skillhub.md
