Agent Skills
返回列表
JSON 数据处理助手

JSON 数据处理助手

数据分析 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_da03281c/jsonformatter。

技能介绍

你在对接 API 或读配置时遇到的问题

日志里一行 {"code":0,"data":{...}} 很难肉眼定位字段;复制进编辑器又常遇到尾逗号、单引号、未转义换行导致的 JSONDecodeError。要把同一份数据给前端做类型、给运营导出 CSV,或从嵌套对象里取出某个数组元素,往往要在 jq、在线工具和脚本之间来回切换。

技能如何工作

这是一个对话式 JSON 处理助手,默认只输出结果,不展示「正在解析」之类中间日志。底层优先用 Python 标准库(json、csv、yaml)和 jsonpath-ng 执行;库不可用时才回退为模型侧文本处理。

  • 格式化 / 压缩:格式化用 json.dumps(..., indent=2, ensure_ascii=False),不手拼缩进;压缩即去掉多余空白。
  • 校验与修复:用 json.loads() 捕获 JSONDecodeError,可给出行号、列号、错误信息;修复流程会列出可修复项并询问是否应用。
  • JSONPath 查询:支持 $.key.subkey、$.arr[0] / $.arr[*]、过滤 $.arr[?(@.price > 10)]、$..key 递归、切片如 $.arr[-1:];不支持脚本表达式、跨层级 @ 引用和正则过滤。
  • 格式转换:JSON↔YAML(YAML 输出禁止 !!python/ 等不安全标签);JSON→TypeScript(按字段类型推断 interface);JSON→CSV(仅对象数组,header 为 key 并集,嵌套对象一层展开为 parent.child);JSON→XML。
  • 结构分析:固定模板输出类型分布、键列表、嵌套深度等;列表过长会截断并标注总数。
  • 大文档预览:格式化后可生成本地 可折叠 HTML 预览(字段数、深度统计);对话里避免同一份 JSON 既完整代码块又完整预览重复输出。

适用边界

  • 输入超过 50000 字符、嵌套深度超过 20 层,或检测到疑似循环引用(如重复 $ref 模式)时会拒绝执行并说明原因。
  • JSONPath 仅实现文档列出的子集;复杂表达式应改用脚本或完整 jq 工具链。
  • CSV 转换要求根结构为 [{...}, {...}];非对象数组需先 reshape。
  • 只有用户消息里出现「详细」「看过程」「步骤」等词时,才会展开中间步骤;否则保持短结果(查询只给路径与值,分析只给统计模板)。

使用场景

  • 联调第三方接口时响应体 `JSONDecodeError`,需要根据行号、列号定位尾逗号或未转义字符并确认是否应用自动修复。
  • 从网关或消息队列 payload 的嵌套结构里,用 JSONPath 取出如 `$.data.list[*].orderId`,不必临时写 Python 递归脚本。
  • 落库或导出的根结构是对象数组 `[{...}]`,要生成带 key 并集表头的 CSV,嵌套字段一层展开为 `parent.child` 给 Excel 核对。
  • 后端提供的样例 JSON 要推断成 TypeScript `interface` 或压成单行/minify 后贴进文档,同时做结构分析看键名与嵌套深度。

适合人员

  • 负责 HTTP/RPC 联调、经常在日志里粘贴原始 JSON 并要做语法校验与 JSONPath 取字段的后端工程师
  • 根据接口样例写请求层与类型定义、需要把 JSON 转成 TypeScript 结构的前端或全栈开发者
  • 处理压缩单行 JSON 或大文档、需要格式化、结构统计或可折叠 HTML 预览以便走读的测试工程师或 SRE
  • 要把 JSON 与 YAML 互转、或将对象数组导出 CSV 做字段核对的数据分析、运营或技术支持人员