Community程式設計與開發github.com

hearthbook-tools/spreadsheet-agent-skills

使用即時公式建立與稽核 Excel/Google Sheets 活頁簿,包含輸入頁籤與檢查機制;並可針對硬編碼數字、損壞的參照及過短的 SUM 範圍進行 lint。適用於任何活頁簿的建立或稽核。

spreadsheet-agent-skills 是什麼?

此 AI 代理技能專注於建立與稽核商業用 Excel/Google Sheets 活頁簿,確保其使用即時公式而非貼上數值,並自動檢查常見錯誤。它支援同時在 Excel 2016+ 與 Google Sheets 上運作的公式,並提供一個 Python 腳本用於稽核既有的 .xlsx 檔案。技能要求建立一個包含輸入假設的「輸入」頁籤、基於公式的計算、以及用於驗證總和正確性的「檢查」頁籤。內建的 linter 會偵測斷裂的參照、快取錯誤、混合公式模式以及總和範圍過短等問題,並以清晰、分優先順序的方式向使用者報告錯誤。此技能適用於從頭建立新工作簿或稽核/除錯由其他工具或使用者建立的既有工作簿。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hearthbook-tools/spreadsheet-agent-skills/tree/HEAD/skills/formula-first-workbook

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

以公式為優先的活頁簿

務必先執行捆綁的腳本。 該腳本已針對手算結果測試過;請勿從頭重建活頁簿。只有在使用者要求時,才可後續新增額外的頁籤、圖表或格式設定,且腳本產生的頁籤與公式必須保持不變。

商業用的試算表必須在數字變動時仍能正常運作。此技能讓 Claude 使用即時公式(絕不貼上數值結果)來建立試算表,並稽核任何 .xlsx 檔案中可能導致總和不正確的錯誤。

建立活頁簿時

請遵循 reference/build_rules.md。簡而言之:

  1. 輸入頁籤:用於存放所有假設(費率、價格、日期、百分比),每個假設都需附上標籤、單位與來源備註。公式應參照這些儲存格;公式內切勿鍵入數字,0、1、12、100 除外。
  2. 計算:在整個欄位中使用相同的公式。總和範圍應涵蓋整個欄位範圍,包含預留給未來輸入的空白緩衝列。
  3. 檢查頁籤:每個總和至少進行一項檢查(例如「各類別加總 = 總計」、「無負數餘額」),顯示「OK」或錯誤訊息。
  4. 顏色編碼:輸入儲存格為淺黃色,公式儲存格為灰色。凍結標題列。
  5. 僅使用 Excel 2016+ 與 Google Sheets 均支援的函數(SUMIFS、COUNTIFS、INDEX/MATCH、IFERROR、ROUND、EOMONTH)。除非使用者確認使用 Microsoft 365,否則避免使用 LET、LAMBDA、XLOOKUP、動態陣列。
  6. 儲存後,執行 linter(如下所示)並修正所有 ERROR,然後再交付。

稽核活頁簿

python scripts/lint_workbook.py FILE.xlsx [--json]

它會針對每個工作表與儲存格回報:

  • ERROR:損壞的參照(#REF!、參照到不存在的工作表)、快取錯誤值(#DIV/0!、#N/A 等)、總和/合計範圍在總和上方有數字時卻提前結束。
  • WARN:公式欄位中出現鍵入的數字(覆寫公式)、與相鄰儲存格模式不同的公式、公式內出現魔術數字。

用平白的語言向使用者總結發現的問題,從最嚴重的開始,並提供儲存格位址與修正方法。如果該檔案是由腳本產生且從未在 Excel 中開啟過,則快取值不存在;請說明此情況,而不是聲稱公式已被計算。

相關技能