Agent Skills
返回列表
CSV 转 JSON 工具

CSV 转 JSON 工具

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/csv-json-converter。

技能介绍

要解决的问题

团队里常见的一类需求是:手头是 CSV 文本或导出文件,下游接口、脚本或文档需要的是 JSON。手写解析要处理分隔符、表头、空行和异常行,还要在 Agent 对话里反复粘贴大段数据,既慢也容易在字段类型或嵌套结构上踩坑。

本技能面向 Expanso csv-to-json 工作流:在支持 SKILL.md 的 Agent 里,把 CSV 作为 content 输入,按约定协议完成转换并返回处理结果与执行状态。

核心能力与关键步骤

调用侧主要参数如下(资料中的输入定义):

  • content:待处理的 CSV 内容
  • mode:输出形态,可选 json / text / markdown
  • max_retries:单步最大重试次数(默认 2)
  • skip_steps:跳过的步骤编号,用于 断点续传

典型路径是:准备目标数据与配置参数 → 通过工具协议触发 CSV→JSON 处理 → 检查返回的处理结果与状态。FAQ 中说明支持常见分隔形式(逗号、制表符等),可对异常数据给出检测报告;批量转换在说明中亦有提及。付费版相对免费版额外覆盖大数据流式处理、多源关联、图表生成、定时同步与数据质量规则等(资料中的能力表)。

中间产物可参考模板:assets/expanso-csv-to-json_template。

适用边界与注意点

  • 不适用于需要人工判断的复杂决策场景(资料明示)。
  • 技能分类为 MD+execute(),依赖 Agent 内置 LLM API;无可用 API Key 时无法使用,密钥勿入库。
  • 执行环境需符合资料要求(Windows / macOS / Linux 均可);若遇 401、429、504 或格式不支持等问题,可按资料中的异常恢复表逐项排查参数、日志与环境。

使用场景

  • 接口联调前,把运维导出的逗号分隔 CSV 粘贴给 Agent,按 json 模式生成请求体样例
  • 数据管道脚本需要 JSON 数组时,用 content 传入表头+行数据,避免本地再写解析脚本
  • 长任务中断后,用 skip_steps 从指定步骤续跑 CSV 转 JSON,核对执行状态再继续下游
  • 把制表符分隔的报表文本交给技能,选 markdown 模式输出便于写进技术说明或评审文档

适合人员

  • 负责把业务方 Excel/CSV 导出转成后端 JSON 配置的后端工程师
  • 在 Expanso Agent 对话里编排数据处理、需要统一工具协议的数据分析师
  • 维护 ETL 文档、要把样例 CSV 同步成 JSON/markdown 附录的技术写作者
  • 对接第三方 API、需在对话中快速验 CSV 字段映射的全栈开发者