xlsx

xlsx skill 概覽

xlsx 的用途

xlsx skill 適合用在「試算表檔案是主要輸入，或最終必須交付試算表檔案」的工作。當你需要讀取、建立、修復、更新或轉換 .xlsx、.xlsm、.csv 或 .tsv 檔案，而且最後要交付的是可直接使用的試算表，而不只是說明或腳本時，就該用它。

哪些情境最適合 xlsx skill

這個 xlsx skill 最適合需要在 agent 工作流程中穩定處理試算表的人：例如財務模型、營運追蹤表、表格資料清理、範本更新、大量公式填入、格式修正、可直接做圖表的活頁簿，以及檔案格式轉換。特別是當使用者提供了實際檔案路徑，並期待你回傳修改後的 workbook 時，這個 xlsx skill 會更有價值。

xlsx 真正解決的工作需求

大多數使用者其實不是要一個泛泛的「幫我分析這個表格」提示。他們需要的是一個能正常開啟、保留既有結構、格式合理、而且不會把公式弄壞的 workbook。xlsx skill 的核心就是這個很實際的結果：產出能真正用在 Excel 類工作流程中的試算表檔案，而不只是描述應該怎麼做。

xlsx 與一般做法有何不同

xlsx 最明顯的差異，在於它對輸出品質的要求很嚴格。這個 skill 強調專業等級的試算表交付物、公式零錯誤，以及在編修既有檔案時盡量保留原本範本。repo 也附了用來解包／重打包 Office 檔案，以及透過 LibreOffice 重新計算公式的輔助腳本，這比單靠 prompt 的一般試算表流程更具體、更可落地。

採用前要先知道的限制

如果你真正要交付的是 Python ETL、資料庫 pipeline、Google Sheets 整合、HTML 報表，或 Word 文件，那這就不是對的選擇。它也不是通用型的試算表理論教學。xlsx skill 的價值相當聚焦：只有在「檔案完整性」與「workbook 輸出」比抽象討論資料本身更重要時，才特別有用。

授權與使用限制

repository 內的 skill 材料受 Anthropic 條款約束，另外 LICENSE.txt 也有附加限制。對技能目錄使用者來說，實務上可直接這樣理解：把它當成服務內部使用的 skill 資源，而不是可以任意抽出、重用、再散布的開源試算表工具包。

如何使用 xlsx skill

xlsx 的安裝情境

repository 並沒有在 SKILL.md 裡明列專用安裝指令，但在 Anthropic skills 工作流程中，常見加入方式是：

npx skills add https://github.com/anthropics/skills --skill xlsx

安裝後，只要任務核心是建立或修改試算表檔案，就應該優先呼叫這個 xlsx skill。

xlsx skill 需要哪些輸入

請提供實際檔案脈絡，不要只丟一個模糊目標。較好的輸入包括：

• 檔案路徑或上傳的 workbook
• 工作表名稱
• 目標欄位或範圍
• 預期公式
• 格式需求
• 是否必須完整保留既有範本
• 需要的輸出格式：.xlsx、.xlsm、.csv 或 .tsv

如果 workbook 本身很亂，也要明確說明哪一列算是標題列、哪些欄位才是準確依據，以及格式異常的列應如何處理。

把模糊需求改寫成可用的 xlsx prompt

較弱的 prompt：

• 「修好這個試算表。」

較好的 xlsx 使用 prompt：

• 「更新 forecast.xlsx。在工作表 Q3 Plan 中，於 H 欄後新增一欄 Gross Margin %，為所有已有資料的列填入公式，保留其他地方所有既有格式與公式，並確保此 workbook 開啟時沒有任何公式錯誤。」

這種具體程度很重要，因為 xlsx skill 優化的是檔案輸出品質，不是替你猜測需求。

能提高 xlsx 輸出品質的 prompt 模式

一個可靠的 xlsx for Spreadsheet Workflows prompt 範本是：

1. 指出檔案
2. 指定涉及的工作表
3. 說明結構上的變更
4. 定義計算規則
5. 說明保留規則
6. 指定需要回傳的輸出檔案

例如：

• 「使用 sales_template.xlsm，只更新 Monthly Summary 與 Raw Data 兩個工作表。將附上的 CSV 匯入 Raw Data，不要動到 macros，保留所有既有樣式，重新整理相依公式，並回傳修正後的 .xlsm。」

這種寫法更能讓 xlsx skill 產出符合預期的結果。

實務上建議的 xlsx 工作流程

一個實用的 xlsx 使用流程通常是：

1. 先檢查 workbook 結構與分頁
2. 判斷這是全新建立、範本編修，還是修復任務
3. 針對特定工作表進行精準修改
4. 檢查公式與參照
5. 必要時重新計算
6. 以指定格式回傳 workbook

這套順序能降低最常見的失敗情況：看起來改好了，但實際上把下游參照或範本慣例弄壞。

想先理解 xlsx skill，請先看這些 repository 檔案

如果你想在採用前先搞清楚這個 skill 怎麼運作，建議先從這裡開始：

• skills/xlsx/SKILL.md
• skills/xlsx/scripts/recalc.py
• skills/xlsx/scripts/office/unpack.py
• skills/xlsx/scripts/office/pack.py
• skills/xlsx/scripts/office/soffice.py
• skills/xlsx/scripts/office/validate.py

這些路徑是理解實際行為最快的方式，比只看高層描述更有判斷依據。

為什麼這些輔助腳本很重要

這些內附腳本顯示 xlsx 不只是單純改表格。repo 支援 Office 檔案的 unpack/pack 流程，也能透過 LibreOffice 重新計算公式。當一般 workbook 編修造成快取公式未更新，或你需要更可控地處理 OOXML package 內容時，這些能力就很關鍵。

重新計算公式與 LibreOffice 的要求

scripts/recalc.py 會使用 LibreOffice 強制重新計算公式並儲存 workbook。若你需要交付的 workbook 已更新為最新計算值，尤其是在做過結構性修改之後，這會很有用。從採用角度看，若你的環境能執行 soffice，這個 xlsx skill 的可信度和實用性會更高。

需要及早知道的環境相依性

如果你打算圍繞這些內建腳本做更深入的 xlsx 自動化，通常要預期以下依賴：

• 執行輔助腳本所需的 Python 環境
• openpyxl
• LibreOffice / soffice
• 在某些環境中，scripts/office/soffice.py 所使用的 soffice shim 路徑可能還需要像 gcc 這類編譯器

這不一定會阻礙一般 skill 使用，但會直接影響你能否在本機重現 repo 的驗證與重新計算流程。

要保留範本時，xslx 編修指示一定要寫清楚

這個 xlsx skill 最重要的使用原則之一，就是更新既有範本時要明確要求「完整保留原樣」。如果你是在修改財務模型、董事會報告 workbook，或受監管的標準範本，請明寫：

• 不要重新調整整個 workbook 的樣式
• 保留字型、欄寬、數字格式與工作表順序
• 只修改指定的儲存格、欄位或分頁

如果少了這些限制，一次看似完成任務的試算表編修，仍然可能在商業場景中算失敗。

xlsx 最強的使用場景

xlsx skill 最擅長的是具體、範圍明確的工作：

• 新增公式
• 清理匯入資料列
• 把 CSV/TSV 轉成可用的 workbook
• 更新既有工作表且不破壞版面
• 產出對公式錯誤容忍度很低、可直接交付的專業試算表

如果你的目標其實是探索式資料分析，而最後要去 notebook、SQL 工作流程或 BI 工具，那 xlsx 的優勢就沒那麼明顯。

xlsx skill 常見問題

xlsx 比一般試算表 prompt 更好嗎？

通常是，前提是你要交付的真的是 workbook。一般 prompt 往往偏向解釋或建議；xlsx skill 則是以試算表交付物、workbook 結構保留，以及實際檔案編修限制為核心設計。

xlsx skill 對新手友善嗎？

友善，只要你的任務夠具體。新手只要提供檔案、講清楚想怎麼改，並避免像「把這份表做得更專業一點」這種定義不足的要求，通常就能把 xlsx skill 用得不錯。它在 workbook 任務明確時表現最好。

什麼情況不該用 xlsx？

如果你的最終交付主要是以下內容，就不建議用 xlsx：

• 腳本
• 資料庫工作流程
• 網頁報表
• Google Sheets API 整合
• 不需要試算表檔案的敘述型分析

在這些情況下，xlsx skill 帶來的價值通常不如偏向程式、分析或報表的 skill。

xlsx 能處理公式壞掉和 workbook 修復嗎？

這正是選它的重要原因之一。xlsx skill 明確把「公式零錯誤」列為優先目標，repo 也包含重新計算支援。不過，修復品質仍取決於你是否把 workbook 原本應有的邏輯講清楚。

xlsx 也能處理 CSV 和 TSV 嗎？

可以。xlsx skill 也涵蓋 .csv 與 .tsv，尤其適合需要把表格資料清理、重整，或轉成正式試算表輸出的情境。

xlsx 適合處理含巨集的檔案嗎？

有可能，特別是對 .xlsm 檔案做範圍有限的更新時。不過，含巨集的 workbook 風險更高。請明確要求保留 macros，並避免無關修改，因為最安全的用法是精準修改，而不是深入重構 VBA。

如何提升 xlsx skill 的效果

提供商業規則，不要只給編修指令

想讓 xlsx 結果更好，最快的方法就是把 workbook 的邏輯講清楚。不要只寫「把公式往下填」，而要寫成像「在 Transactions 中，對每一列非空資料計算 Net Revenue = Gross Revenue - Discounts - Refunds」。這樣 xlsx skill 比較能抓到結構不一致和公式邊界情況。

一開始就講清楚哪些不能動

若想把 xlsx 用得穩，請先寫明哪些內容不能改：

• 工作表名稱
• 目標範圍外的公式
• macros
• 格式
• 隱藏分頁
• named ranges
• 欄位順序

這些限制往往比籠統的風格要求更重要，因為試算表任務最常失敗的原因，就是不小心動到了不該動的地方。

面對髒資料時，降低歧義

如果來源資料不一致，請直接告訴 xlsx skill 應該如何正規化：

• 哪一列才是真正的標題列
• 空白列是否應刪除
• 重複 ID 要怎麼處理
• 日期格式是 MM/DD/YYYY 還是 DD/MM/YYYY
• 哪些值應視為 null

這些資訊，常常就是「能交付的 workbook」和「表面上看起來有整理過」之間的差別。

不只要求輸出，也要求驗證

更好的 xlsx guide prompt 會要求一起做這些檢查：

• 確認不再有公式錯誤
• 驗證插入欄位後的工作表參照是否正確
• 保留未修改區域的既有樣式
• 確保總計與彙總仍然對得起來

這些檢查正好對準 xlsx skill 最有價值的地方：可信賴的試算表輸出。

第一版 workbook 出來後，用迭代方式修正

拿到第一版結果後，請優先檢查：

• 幾列具代表性的公式
• 邊界位置的格式
• 總計與彙總
• 看起來像外部參照的連結
• 清理資料時可能隱含的假設

接著再下第二個、範圍更窄的 prompt。xlsx 工作通常用這種迭代方式進步更快，因為你一次只修正一種 workbook 行為，而不是把整個任務重講一遍。

注意 xlsx 常見失敗模式

xlsx 最常見的失敗模式包括：

• 插入欄位後參照壞掉
• 公式複製到錯誤的列範圍
• 不小心重設既有範本樣式
• 文字數字或日期解析錯誤
• 跳過重新計算，導致計算值過期

如果你的 workbook 對業務很關鍵，這些問題最好直接寫進 prompt。

提供範例列與目標結果，能讓 xlsx 更準

如果可以，請提供：

• 3 到 10 列具代表性的資料
• 一個正確最終公式的範例
• 一個期望格式的範例
• 一個錯誤資料列的範例，以及應如何修正

對 xlsx for Spreadsheet Workflows 來說，範例通常比抽象指示更有效，因為它能同時固定結構與預期輸出。

重視完整性時，直接用 repo 腳本來評估 xlsx

如果你是認真評估這個 xlsx skill，建議直接檢查並使用這些輔助腳本，而不是只快速掃過 SKILL.md。unpack.py、pack.py 和 recalc.py 能清楚反映 repo 在 OOXML 處理、驗證與重新計算上的實際做法。這會比泛泛的功能摘要，更能幫你做出安裝與採用判斷。

了解 xlsx skill 的能力上限

xlsx skill 能提升試算表輸出的可靠性，但在複雜財務模型、稽核模型或法規相關模型中，它不能取代領域審查。如果一條錯誤公式就可能造成重大風險，請把 xlsx 當成加速器，而不是最終把關者，並務必仔細檢查 workbook 邏輯。