Agent Skills
返回列表
📊

CSV 解析与生成

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/csv-free-tool

技能介绍

在数据处理流水线中,CSV 看似简单,实则暗藏诸多边界陷阱。从 Excel 导出的 UTF-8 BOM 头导致解析错位,到欧洲区域使用分号作为分隔符,再到字段内包含换行符引发的行数计算错误,这些问题往往会让自动化脚本直接崩溃。

解决的核心痛点

本技能专注于攻克 CSV 在跨工具流转时的格式违例问题。它严格遵循 RFC 4180 标准,强制处理包含逗号、引号或换行符的字段必须使用双引号包裹的规则。针对不同区域的导出习惯,它能够自动嗅探 ;、\t 或 | 等非标准分隔符,并妥善处理 UTF-8 BOM 与 Latin-1 编码的歧义,避免乱码或数据截断。

技能工作原理与关键步骤

Agent 在接收到处理请求时,会按以下逻辑执行:

  • 环境与预处理:验证输入数据的规范性,通过首行特征嗅探实际分隔符,并明确声明编码格式。
  • 解析与转义:在解析阶段,正确处理引号字段内的换行符,以及通过 "" 转义内部双引号。同时严格区分空字段 ,, 与空字符串 "," 的语义差异。
  • 生成与防注入:输出时,若目标为 Windows 版 Excel,会主动添加 BOM 头。针对以 =、+、-、@ 开头的字段,自动添加前置符以防止公式注入;对超过 15 位的长数字强制格式化为文本。

适用边界与注意事项

需要注意的是,该技能仅处理静态文本的解析与生成,不支持 Excel 公式的计算与求值。此外,日期格式必须严格符合 ISO 8601 (如 2024-01-15),不支持 01/02/24 等模糊写法。输入数据的大小与字段数量受底层 Agent 平台内存限制,超大文件仍需配合传统的数据流处理工具使用。

使用场景

  • 收到欧洲 Excel 导出的分号分隔 CSV,需转换为逗号分隔供下游脚本读取
  • 字段内含逗号、引号或换行符,需按 RFC 4180 规则正确包裹以便其他工具解析
  • 处理用户导入的 CSV,其中包含以 = 或 + 开头的文本,需防止被 Excel 识别为公式
  • 导出含中文的 CSV 给 Windows Excel 用户,需添加 UTF-8 BOM 避免乱码

适合人员

  • 后端工程师,需将数据库查询结果导出为 CSV 供下游系统消费
  • 数据分析人员,经常处理多来源导出的异构 CSV 文件并进行清洗
  • 全栈开发者,构建文件上传功能时需防范 CSV 公式注入攻击
  • BI 工程师,需将清洗后的数据生成标准 CSV 导入到 Excel 报表中