Excel Skill

Excel Skill

给 AI agent 用的 Excel 工具包：结构化知识库 + 5 大行业模板生成器 + 健康度诊断 + Python 自动化脚本。

让 Cursor / Claude Code / Codex 等 AI agent 直接按需求生成能用的 Excel 文件、公式、透视表、Dashboard，省去反复查文档。

v2 新增

模块	作用
scripts/analyze.py	给现有 .xlsx 做"健康度诊断"（10 类常见坑：中文逗号、#REF!、整列引用、sheet 名违规等）
scripts/generate_saas/unit_economics.py	第 5 个行业 vertical：SaaS LTV / CAC / Cohort / P&L Projection
tests/test_generators.py	5 个 generator 的集成测试（跑完产出能被 openpyxl 读回 + 无 #REF!）
tests/test_analyze.py	analyze.py 检查项测试（含合并单元格回归）
references/04-vba-vs-python.md	VBA vs Python 决策矩阵
references/06-cell-protection.md	单元格保护 + 数据校验
references/07-charts-and-formatting.md	图表类型 + 专业配色（避免 "AI 蓝紫" 既视感）
.github/workflows/test.yml	CI 跑全套 pytest

---

这个项目要解决什么

我（项目作者）和很多金融/快消/电商/互联网从业者一样，工作离不开 Excel，但又不是 Excel 重度老用户：

• 知道有公式但记不住具体语法（SUMIFS 还是 SUMIF？INDEX/MATCH 还是 XLOOKUP？）
• 知道 Power Query 牛但学习曲线陡（界面操作 + M 语言）
• 想用 Python openpyxl 自动化但每次都查文档
• 行业里大家都在用某些"约定俗成"的报表样式（金融三表、电商漏斗、快消 RTM 等），但 Google 出来的模板大多不对版

让 AI 帮我处理这些是最快的——但 AI 经常：

• 编错的公式参数（"VLOOKUP 第三个参数应该是 0 还是 FALSE"）
• 用 pandas.read_excel + to_excel 时把所有公式变成字符串（最经典的坑）
• 生成的 openpyxl 代码在「formula 在 openpyxl 里只是字符串，需要重算」这点上踩坑

这个项目就是给 AI 一份**结构化知识库 + 行业模板库 + 一组可复用脚本**，让它一次给对。

---

它和已有项目的关系

项目	Stars	我们怎么用
Anthropic 官方 xlsx skill	-	通用 xlsx 操作的标准实现，我们 reference 它
`claude-office-skills/skills`	-	通用 openpyxl 知识，我们做行业化补充
`davepoon/buildwithclaude`	3K	含 recalc.py 公式重算，我们 fork 思路
`sartrus/modelling-team-skill`	-	三 agent 团队建财务模型，我们参考它的 Architect/Coder/Challenger 分层
`LondonMarket/Financial-Model-Excel-Template`	9	DCF 模板，我们的金融行业部分 reference
熊猫办公 / 各模板站	-	中文社区主流