| name | spreadsheet-analysis |
| description | CSV/XLS/XLSX/XLSB/ODS 表格的读取、探查、清洗、汇总与写出；CSV 围绕「表」的读/洗/汇总/写出也走本 Skill；批量管道/报告/重命名走 data-processing；DOC/PDF 不属本 Skill。 |
表格分析与处理
When to use
- 用户上传或引用了
.csv / .tsv / .xls / .xlsx / .xlsb / .ods，需要探查结构、清洗、汇总统计、写出新表格。
- 需要对表格做 pandas 分析、生成报表或给下游（图谱、报告、前端图表）喂干净数据。
不是本 Skill 的职责：纯文本/JSON 的批处理与报告生成（→ data-processing）；.doc/.docx/.rtf/.html 正文抽取（→ document-conversion）；.pdf 解析（→ pdf-processing）。CSV 归属裁决：围绕"表"的探查/清洗/汇总/写出（inspect/clean/summarize/write_xlsx）→ 本 Skill；批量管道/报告/重命名（csv_profile 只是流水线一环）→ data-processing。
决策顺序
- 先
inspect_table.py 看列名、类型、行数、前几行，确认编码与分隔符。
- 清洗/转换 →
clean_table.py（选列、去空、填值、重命名、过滤），产物 CSV/XLSX。
- 统计 →
summarize_table.py（describe、null 统计、唯一值）。
- 写出 →
write_xlsx.py（把结构化行写入带表头的 XLSX）。
- 组合优先：
inspect → clean → summarize → write；大文件按列选择/分块处理。
脚本索引
| 脚本 | 用途 |
|---|
inspect_table.py | 列名/类型/行数/样例（结构探查） |
summarize_table.py | describe + null + 唯一值统计 |
clean_table.py | 选列/去空/填值/重命名/过滤 → 新表 |
write_xlsx.py | 结构化行 → XLSX |
组合路线
CSV ──inspect──> 结构
CSV ──clean──> 清洗.csv ──summarize──> 统计.json
清洗结果 ──write_xlsx──> 报表.xlsx
安全与限制
- 离线运行，不联网、不执行包安装、不读取 secret。
- 只读工作区内文件；路径限制同其他脚本。
- 读取
xls/xlsb/ods 依赖 xlrd/pyxlsb/odfpy——较旧格式可能失败，如实说明。
- 公式：openpyxl 默认读缓存值；不重新计算公式。
详细说明
组合配方见 references/best-combinations.md，输入/输出契约见 references/input-output-contract.md，常见失败见 references/troubleshooting.md。每个脚本的完整用法见 scripts/*.md。
