YAML
YAML编写、调试与验证专家
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：YAML。 它的用途是：YAML编写、调试与验证专家 完整的 Skill 内容见：https://321skill.com/skills/yaml-x-9/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'这是我的Kubernetes Deployment YAML，部署时一直报错“error converting YAML to JSON”，请帮我检查缩进和隐式类型转换问题。' 它会逐行分析，指出第5行用了Tab、第12行`replicas: 3`没有引号但没问题，但第18行`imagePullPolicy: Always`被误解析为布尔值？实际上不会，但会关注如`enabled: yes`等。同时建议使用yamllint规范化，并输出修正后的YAML。
介绍
YAML 作为广泛使用的配置文件格式，常因隐式类型转换（如 no 变布尔值、1.0 变数字）、缩进错误、锚点别名失效、重复键值冲突等问题导致跨语言解析不一致或工具链断裂。本 Skill 专门解决此类痛点，能定位并修复 YAML 文件中的语法、语义和兼容性问题，确保同一份文件在 Python、JavaScript、Go、Kubernetes、Helm、GitHub Actions、Ansible 等不同环境和工具中解析结果一致。
使用时，只需将出错的 YAML 文件内容或相关代码片段发送给 AI，说明具体现象（如“文件无法解析”、“值被自动转换”、“某工具加载失败”），Skill 会逐行检查缩进、引号、特殊字符、键值覆盖、锚点合并等细节，并给出修复建议。同时支持调用 yamllint 进行语法检查、利用 schema 验证数据结构、使用 yq 进行查询修改，以及输出语义化的差异对比，帮助快速定位差异点。
适合后端开发者、运维工程师、全栈开发者以及任何需要频繁编写或维护 YAML 配置文件的专业人员。无论是 Kubernetes 资源清单、CI/CD 流水线配置、Docker Compose 文件，还是 Ansible Playbook 的变量定义，都能从中受益。对于团队协作中因 YAML 解析差异导致的线上故障排查尤其有效。
建议在使用前明确告知 AI 你的目标工具链（如“这段 YAML 要用于 Helm 3”、“需要在 GitLab CI 中解析”），以便进行针对性校验。注意本 Skill 不处理 JSON、TOML、XML 格式，也不涉及 Ansible Playbook 的语义逻辑（如任务执行顺序），仅专注于 YAML 本身的语法和跨工具兼容性。
核心特点
与通用的 yamllint 或在线校验器不同，本 Skill 不仅检查语法，还能识别和修复跨语言/跨工具的解析差异（如隐式类型转换、锚点合并失效、重复键值选择规则），并覆盖 yq、schema 验证、语义差异等完整工具链。
注意事项
不适用于 JSON、TOML、XML 格式，也不涉及 Ansible Playbook 的语义逻辑或业务逻辑验证。
常见问题
YAML 中 `yes` 或 `no` 为什么会被解析成布尔值？
YAML 规范中 `yes`/`no`/`true`/`false` 等会被自动转为布尔值，需要在值上加引号显式声明为字符串，如 `'yes'`。
YAML 缩进用空格还是 Tab？
必须使用空格，Tab 不被允许。建议统一用 2 空格缩进，并确保同一层级缩进一致。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/yaml-x-9/raw/index.md 读取 YAML 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/yaml-x-9/raw/index.md（查看排版版本）