spreadsheet-analysis

电子表格分析

保留源工作簿，区分存储值与公式，并通过可复现的检查支持每项结论。

输入

收集或说明：

• 源文件、业务问题、目标受众、输出格式和验收标准。
• 相关工作表/区域、键、单位、货币、日期/时间时区、会计正负号和报告期间。
• 是否必须保留公式、格式、批注、隐藏内容、宏、外部链接、数据透视表、图表和保护设置。
• 用于核对的权威总计或源系统。
• 保密限制，以及是否必须仅在本地处理。

不要猜测未标注字段或含义不明的空白、零、百分比、日期和 ID 的含义。记录假设。

输出约定

返回：

1. 源路径、哈希、格式、工作簿/工作表清单和分析范围。
2. 调查结果，包括指标定义、公式或方法、筛选条件、单位、期间、分母和证据位置。
3. 将数据质量和公式问题与业务结论分开。
4. 如需编辑，创建新的输出工作簿/数据文件；绝不静默覆盖源文件。
5. 核对、重新计算、重新打开和目视检查的结果及其局限。

明确标注计算值、估算值、缓存值、缺失值和外部来源值。如果仅读取了公式的缓存结果，不要声称工作簿已重新计算。

工作流

1. 保留并清点

• 确认准确路径，计算源文件哈希，并在副本或新的输出路径上操作。
• 不要在启用宏的情况下打开不可信工作簿，也不要刷新外部连接。
• 对 CSV、TSV、XLSX 或 XLSM，运行此技能目录中附带的只读分析工具，清点文件：

python3 scripts/profile_table.py /path/to/data.csv --pretty
python3 scripts/profile_table.py /path/to/workbook.xlsx --pretty
python3 scripts/profile_table.py /path/to/data.csv --output /path/to/profile.json --pretty

该脚本使用 Python 标准库，按逻辑记录读取 CSV/TSV（包括带引号的多行字段），应用字节数/行数/字段数/成员数限制，不计算公式，也不修改文件。它不会输出经分析的数据行单元格值，但会输出表头、工作表名称、计数、数值范围和结构元数据。使用 --output 时，它会拒绝与输入文件相同的路径别名和非普通文件目标，然后通过同目录临时文件以原子方式创建或替换报告。状态为 partial、row_limit_reached 或 skipped_* 表示清点不完整；请查看注明的限制，不要将分析结果视为最终结论。

2. 选择可用的工具链

阅读 tool-routing.md。选择工具前，先清点已安装的电子表格应用、Python/JavaScript 库和转换器。公式、样式、图表、数据透视表、宏或命名区域至关重要时，优先使用能识别工作簿结构的引擎。理解工作簿语义后，进行表格数据分析时优先使用 DataFrame/查询引擎。

未经许可，不要安装依赖项、上传数据或转换格式。转换可能会丢失公式、格式、宏、日期、批注、图表或多个工作表。

3. 打开或渲染基线

如有可信的电子表格应用程序，请在其中打开原文件。对于不可信的原文件，必须采用第 8 步定义的控制措施：输入文件设为受保护/只读，禁用宏/VBA/事件/加载项/DDE，禁止刷新链接/查询，并断开网络。如果无法验证这些控制措施，请将静态分析器输出保留为部分结果，并停止后续打开应用程序或重新计算的操作。为每个相关工作表以及任何仪表板、打印版式、图表或特殊格式捕获视觉基线。盘点：

• 可见、隐藏和深度隐藏的工作表；使用区域；标题；合并单元格；表格；筛选器；冻结窗格；以及定义名称。
• 公式、缓存值、错误、数组/溢出公式、循环引用和计算模式。
• 外部链接、数据连接、查询、宏、验证规则、批注和保护设置。
• 单位、数字格式、日期系统、区域设置假设以及空白/null 约定。

将隐藏行/工作表纳入完整性和安全范围，但不要自动将其视为分析数据。

4. 明确分析粒度

确定每行代表什么、主键是什么、允许哪些重复项、维度、度量、周期边界以及联接基数。为含义模糊的列创建数据字典。请阅读 analysis-checklist.md，了解数据分析和核对检查。

必要时创建规范化的分析副本；保留源行标识符，以便将每项结果追溯到源数据。

5. 解释前先验证并核对

检查行数、重复键、缺失值、类型漂移、无效类别、日期间隔、异常值、公式不一致、隐藏项排除情况以及联接导致的行数倍增。将关键汇总数与权威控制数据核对，或说明不存在此类控制数据的原因。

分别检查公式和数值。检测公式区域中的硬编码常量、相对引用偏移、正负号混用、范围不一致以及错误抑制。绝不可在不说明的情况下用数值替换公式。

6. 使用明确的定义进行分析

计算前说明指标定义。使用精确的筛选条件、分母、周期逻辑、单位和舍入规则。计算时保留完整精度，仅在呈现时舍入。将描述性结果与预测或因果结论分开。对于预测，记录预测时段、方法、训练窗口、季节性、不确定性和回测表现。

7. 尽量精简地创建输出

仅将请求的更改写入新工作簿或表格。除非有意更改，否则保留格式、公式、名称、隐藏状态、验证规则、宏和图表。若接收者需要可审计的模型，请使用公式；仅在请求时使用固定值，并为其添加标注。

使用 analysis-report-template.md 创建独立的证据记录。

8. 重新计算、重新打开并渲染

添加或更改公式后，仅在受控配置文件中使用实际兼容的计算引擎重新计算。对于不可信的工作簿，请先确认宏、VBA 和工作簿事件、DDE、加载项、外部链接／数据连接刷新、网络访问和自动更新均已禁用。使用隔离的低权限环境，不包含任何机密，并将源文件设为只读。如果无法保证这些控制措施，请勿重新计算不可信文件。

重新打开保存的输出，并验证公式、存储值、错误、名称、链接和工作表结构。渲染或打开每张有更改的工作表，以及具有代表性的未更改工作表。检查标题、列宽、数字格式、被截断的文本、图表范围、打印区域和条件格式。如果任何结果依赖于仍处于禁用状态的宏、事件处理程序、加载项、连接或外部链接，请将该结果标记为 unverified—active dependency not executed；请勿用缓存值代替验证。

重新运行对账，并抽查源行与最终指标。记录可能影响公式或布局的工具／版本差异。

安全与权限边界

• 除非获得明确的上传批准，否则个人、财务、健康、客户和机密数据应保留在本地。
• 不要启用来自不可信工作簿的宏、DDE、外部链接、加载项、查询或刷新。
• 在电子表格软件中重新打开导出的文本时，将以 =、+、- 或 @ 开头的公式视为潜在的公式注入。
• 未经明确授权，不要更改生产工作簿、发布仪表板、发送报告或刷新实时数据源。
• 不要隐瞒排除项、数据质量问题、估算或手动覆盖。
• 不要将预测、财务计算或统计关联说成确定结果。
• 避免记录原始敏感单元格值；请使用行 ID、范围、聚合数据或脱敏样本。

恢复

如果分析或保存失败，请保留源文件和失败的输出，记录确切的工具／版本／错误，并从未更改的源文件重新开始。如果工作簿被意外覆盖，请停止进一步写入，并从版本历史或备份中恢复；不要临时采取破坏性修复。如果外部连接或宏已被激活，请记录运行内容，保留日志，并上报潜在的数据泄露问题。

示例

收入对账

请求：“解释为什么月度收入工作表比总账导出高出 $48,200。”

对两个文件进行哈希校验，明确期间／货币／符号规则，分析键和重复项，按实体和月份对账总额，将差异追溯到确切行或公式范围，并提供包含未解决事项的差异桥接表，而不是强行匹配。

公式审计

请求：“在董事会会议之前检查此规划模型是否存在损坏的公式。”

打开文件时不刷新链接，盘点公式和隐藏工作表，找出不一致的公式和硬编码覆盖值，在兼容的引擎中重新计算，目视检查仪表板，并提供包含严重程度和修正选项的单元格级发现。

清理调查结果

请求：“将此 CSV 转换为包含图表的汇总工作簿。”

保留 CSV，确认编码／分隔符／数据粒度，防止公式注入，记录缺失值和类别映射，计算可复现的聚合数据，创建新工作簿，重新打开该工作簿，并根据清理后的表格验证图表范围和总计。