Community编程与开发github.com

电子表格智能助手技能

构建和审计包含动态公式、输入标签页和校验功能的 Excel/Google Sheets 工作簿;检查硬编码数值、破碎引用和过短的 SUM 范围。适用于任何电子表格的构建或审计任务。

电子表格智能助手技能 是什么?

该技能专为 Claude 设计,用于构建和审计 Excel 及 Google Sheets 工作簿,确保它们使用动态公式而非粘贴的静态结果。其核心是通过一个经过手算验证的脚本生成工作簿,确保在数据变化时公式能自动更新。技能要求工作簿必须包含专门的输入标签页,所有假设(如费率、价格、日期)都有明确的标签、单位和来源注释;计算标签页中的公式必须统一且覆盖整个列范围;校验标签页则提供至少一个自动检查(如“类别总和 = 总计”),并以“OK”或警告消息反馈结果。此外,该技能内置了一个 Python 审计脚本 `lint_workbook.py`,能够检测工作簿中的严重错误(如破碎引用、错误缓存值、不完整的 SUM 范围)和潜在问题(如公式列中的硬编码数值、与相邻公式模式不一致的公式)。用户可以在 Cursor、Codex 或其他支持该技能的 AI 代理中通过引导使用此技能,尤其是在需要构建新工作簿或对现有 `.xlsx` 文件进行质量审计时。

兼容平台✓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. 保存后,运行下面的检查器,修复所有错误后再交付。

审计工作簿

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

它会报告每个工作表及单元格的以下信息:

  • 错误:破碎的引用(#REF!、引用不存在的表)、缓存的错误值(#DIV/0!、#N/A、…)、SUM/总计范围未覆盖总计上方直接数据行之前的内容。
  • 警告:公式列中出现了手动输入的数字(覆盖了公式)、某个公式与其相邻公式的模式不同、公式中的魔术数字。

用通俗语言向用户总结发现,最严重的问题优先,包括单元格地址和修复方法。如果文件是由脚本生成且从未在 Excel 中打开过,缓存的值将不存在;请说明这一点,而不是声称公式已被求值。

相关技能