用途:当用户提供 CSV 文件(上传、写入文件系统或内联)并希望获得结构化摘要或统计分析时使用。典型请求包括汇总 sales.csv、查看文件包含哪些列及其内容、为数值列给出描述性统计、统计每列缺失值。
主要能力:脚本读取 stdin,使用 pandas 对数据做剖析,并向 stdout 打印 JSON 报告。报告键包括 shape、columns、dtypes、missing、numeric_summary、categorical_summary、head。
使用方式:先定位 CSV。若用户提到文件名,调用 fs_list 和 fs_read 在 uploads/ 或指定文件夹下读取内容为字符串;若内容已在先前工具结果或附件中,直接作为 stdin 传入。然后调用 run_skill_script({ name: "csv-analyse", path: "scripts/analyse.py", stdin: <CSV 内容字符串> })。解析 stdout 的 JSON,只展示用户询问的部分,除非用户要求全部。可用 offer_choices 提供 3-5 个后续步骤,如绘制某数值列分布、按条件筛选行、导出摘要到 Word、计算列间相关性。
呈现风格:先给出 shape(行 × 列);仅在缺失值百分比大于 0 时显示;数值摘要保留 3 位有效数字;若文件超过 1 万行,说明分析使用了完整文件而非抽样。
限制与注意:不要猜测列含义,列名含糊时询问用户;不要把完整 CSV 回显到聊天中;若输入看起来不是 CSV(检查首行分隔符),不要运行分析,应请求澄清。