JSON-YAML 格式化校验
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 的指引,将 @user_af163eaa/z-dev-json-yaml-fmt 安装到当前 AI 助手中。
技能介绍
粘贴了一段烂 JSON,问题到底在第几行?
在处理配置、接口返回或者 CI 流水线片段时,拿到一段缩进错乱、多余逗号、单双引号混用的 JSON 或 YAML 是常有的事。人眼定位这类错误的成本远比想象中高——JSON.parse 只会抛出一句 Unexpected token,不会告诉你第 42 行多了个逗号;而 YAML 更隐蔽,a: b: c 这种写法可能被解析成普通字符串而不是嵌套结构,只在下游取值时才炸。真正需要的不是简单"格式化一下",而是格式化 + 语法校验 + 定位到行。
它怎么工作
这个技能面向的是开发过程中的一次性小任务,不是常驻服务:
- 输入:直接粘贴混乱的 JSON/YAML 文本,或说明目标语言与用途。
- 处理:先解析再格式化;遇到语法错误时给出出错位置,而不是整体重写后让你猜改了什么。
- 输出:可复制的代码片段或配置,附带关键行注释、参数说明,以及常见错误的替代写法。
工作流程分三步:理解需求 → 生成可运行的代码/配置或实时校验 → 给出结果与边界提示。如果跑不通,把报错贴回来,它会基于上下文修正,而不是让你自己去查文档。
适用边界
- 定位是程序员小工具,不替代 jsonschema、lint 规则或线上配置中心这类专业能力。
- 生成的代码和配置仅供参考,执行前仍需自测与安全审查;它不会替你运行未知脚本,也不会写入密钥。
- 复杂需求建议拆成小步骤逐步验证,而不是一次性生成大段不可测代码。
使用场景
- 接口联调时拿到后端返回的深层嵌套 JSON,缩进全乱,需要格式化成可读结构再粘贴进代码。
- CI 流水线因配置文件报错中断,需要校验 YAML 语法并定位到具体出错行再提交修复。
- 同事手改过的 JSON 配置担心存在多余逗号或引号不匹配,提交前先校验一遍。
- 编写 k8s 或 compose 配置时,想确认缩进和嵌套结构符合 YAML 规范再应用。
适合人员
- 前后端工程师:接口联调频繁拿到格式混乱的 JSON 返回,需要快速还原结构并排查字段。
- 运维与 SRE:维护 CI 和 k8s 的 YAML 清单,担心手改引入语法错误导致流水线或部署失败。
- 独立开发者:本地配置文件经常手动增删字段,需要提交前确认语法正确。
- 技术支持人员:帮客户排查配置文件报错,需要把出错位置定位到行而非整段重写。