Agent Skills
返回列表
YAML 配置互转器

YAML 配置互转器

开发编程 更新于 2026.08.29

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

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

技能介绍

解决什么问题

运营和研发常常各执一套配置:运营需要可读、可评审的 YAML,系统存储和接口交互更习惯结构化的 JSON。若每次都靠后端接口做转换,跨团队推进效率低且存在数据外传风险。这个技能在浏览器本地完成 YAML 与 JSON 的双向互转,不请求后端,适合配置导入、导出和解析自检。

核心能力

  • 解析与转换:依赖 js-yaml,优先使用 load / dump(或等价 API)完成 YAML ↔ JSON 互转。
  • 双向可用:支持把 YAML 配置导入系统,也支持把 JSON 导出为 YAML,便于后续 diff 和评审。
  • 安全解析:不对不可信 YAML 启用可执行自定义类型,避免开启危险 schema。
  • 稳定输出:dump 采用稳定缩进,例如 2 个空格,减少无效改动。
  • 本地处理:配置留在浏览器中,不上传第三方。

关键步骤

  1. 安装 js-yaml,封装 yamlToJson 与 jsonToYaml 两个核心函数。
  2. UI 使用双栏「YAML ↔ JSON」预览,导入文件统一使用 UTF-8 编码。
  3. 自测时验证样例配置往返一致性,并为坏缩进等解析失败返回中文原因。
  4. 可选地对客户配置做轻量字段校验,确保关键字段在往返后不丢失。

适用边界与注意点

适合运营可读 YAML 的导入、JSON 导出为 YAML 的评审、以及本地配置解析校验。它不负责后端持久化、复杂 schema 管理或跨系统自动同步;处理不可信 YAML 时应保持安全模式,禁止启用自定义类型和危险 schema。

使用场景

  • 运营将 YAML 筛选规则导入系统,JSON 格式直接入库
  • 开发导出 JSON 配置为 YAML,用于代码评审与版本对比
  • 工程师本地校验 YAML 缩进,解析失败返回中文提示
  • 团队在浏览器转换配置,避免上传第三方

适合人员

  • 需要处理 YAML 与 JSON 转换的前端工程师
  • 负责配置导入和格式评审的运营人员
  • 关注配置安全和本地处理的后端开发者
  • 需要校验配置文件格式的测试工程师