技能包

xlsx:把試算表當作主交付物來處理

適合在主要輸入或輸出是 .xlsx 等表格檔案時使用,前提是直接匯入預裝的 openpyxl,寫入公式而不是硬編碼,並在讀值前先重算。

官方來源 · xlsx

安裝

write the script and import directly

適合誰

當試算表是主要輸入或輸出時,使用這份 xlsx 說明。涵蓋開啟、讀取、編輯或修復已有的 .xlsx、.xlsm、.xltx、.csv 或 .tsv。交付物必須是試算表檔案。

不要在主要交付物是 Word、HTML 報告、獨立 Python 腳本、資料庫管道或 Google Sheets API 整合時觸發,即使中間也有表格資料。資料沒有給出代理產品名單,不要理解成某一家軟體獨佔。官方說明頁是

https://raw.githubusercontent.com/anthropics/skills/main/skills/xlsx/SKILL.md

3 分鐘完成第一次嘗試

建議路徑:openpyxl、pandas 和 markitdown 都已預裝,先不要 pip install,直接寫腳本並匯入。

前置:目前環境能直接 import 這三個函式庫。低風險第一次嘗試是唯讀查看,不要先寫盤。對一份本機已有的表格檔案匯入 markitdown 做快速查看;若檔案不存在,停在開啟失敗,不要新建未點名的樣例表。

成功訊號:匯入成功,並且你能看到該檔案的文字概覽。這不是修復或覆蓋。若還沒有現成檔案、且使用者明確要求產出表格,再改用 openpyxl 建立,但寫盤前先確認檔名和是否覆蓋。

建立時記住:要用公式,不要寫入 Python 算好的硬編碼結果。資料示例是把儲存格寫成 =SUM(B2:B9) 這類公式,這樣輸入變化時工作表還能重算。

使用案例

案例一:新建或修改一份會重算的表。用預裝的 openpyxl 寫腳本,匯入後把合計寫成公式,例如 B10 使用 =SUM(B2:B9),而不是先在 Python 裡加總再寫入數字。完成標準是檔案裡是公式,輸入改動後工作表能重算。摘要把 pandas 留給批次讀寫、markitdown 留給快速查看;本案例只涵蓋公式寫入。摘錄沒有給出完整樣式 API,不要編造未出現的格式函式。

案例二:含公式的檔案必須重算後再讀值。資料寫明:只要檔案含公式,重算是強制步驟。openpyxl 把公式寫成字串,沒有快取值;在你重算之前,每個公式儲存格讀回來都是 None。這是可逆檢查:先開啟剛寫完的檔案讀公式格,若得到 None,說明還沒重算,停在這裡,先完成重算再把讀到的值當成結果。不要把 None 解釋成合計為零。

使用界線

只在試算表本身是主交付時使用。Word、HTML、獨立腳本、資料庫管道、Google Sheets API 即使含表也不走這條。三個函式庫已預裝,預設不要先 pip install。公式必須能隨輸入重算;寫完後必須重算,否則讀回 None。

不要把未出現的倉庫路徑寫成安裝命令。不要用硬編碼數字冒充合計。寫盤或覆蓋原表前,先確認目標路徑和副作用,再執行。超出這些已寫明的檔案類型、匯入方式和重算要求,這份說明涵蓋不到。