YAML
YAML 编写、调试与验证专家
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：YAML。 它的用途是：YAML 编写、调试与验证专家 完整的 Skill 内容见：https://321skill.com/skills/yaml-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的 docker-compose.yml 启动时提示 'Invalid type'，请帮我检查并修复。' 它会分析文件中的缩进、类型转换（如端口号被误认为字符串）、锚点引用等，自动输出修正后的 YAML 并解释每个改动原因。
介绍
YAML 是开发者在 Kubernetes、CI/CD、Ansible 等场景中最常用的配置格式，但它的隐式类型转换、缩进敏感、锚点合并等特性常常导致文件在不同语言或工具中解析结果不一致，甚至无意中执行恶意代码。本 Skill 专门解决这些痛点：当你的 YAML 文件无法解析、值被错误地转为布尔值或数字、缩进或冒号导致文档断裂、块标量破坏脚本或密钥、锚点/别名不被工具保留、重复键取错值、同一个文件在 A 解析器正常而在 B 解析器报错、需要编辑或生成 YAML 时保留注释和键顺序、或者处理不受信任的 YAML 时，它都能帮你定位问题并给出修复方案。
使用时只需将出问题的 YAML 文件内容或相关描述粘贴给 AI，它会自动执行语法检查、类型推断、缩进校准、规范验证，并调用 yamllint、schema validation、yq 等工具进行深层分析。你还可以要求它对比两个 YAML 的语义差异、生成严格符合规范的版本、批量修复多个文件，甚至将 YAML 转换为其他格式时保持逻辑一致。
适合后端开发、运维工程师、全栈开发等频繁处理 YAML 配置的人员，尤其是使用 Kubernetes、Helm、GitHub Actions、GitLab CI、Ansible、Docker Compose、CloudFormation、OpenAPI、Home Assistant 等技术的团队。它也适合需要审计 YAML 安全性的安全工程师，以及需要编写高质量 YAML 教程的文档工程师。
注意：本 Skill 专注 YAML 格式本身，不处理 JSON、TOML、XML 等格式，也不涉及 Ansible playbook 的语义逻辑（如变量展开、任务编排）。若你只需简单的语法高亮或格式化，建议使用编辑器自带插件；对于复杂的企业级配置管理，建议结合 schema 定义文件进一步提升可靠性。
核心特点
同类工具只做语法校验或格式化，而本 Skill 能识别并修复跨语言/工具解析不一致的深层陷阱（如隐式类型转换、缩进误导、锚点丢失），同时保留注释和键顺序，确保同一个 YAML 在所有环境中行为一致。
注意事项
不适用于 JSON、TOML、XML 格式，也不处理 Ansible playbook 的语义逻辑。
常见问题
YAML 中 `no` 被解析成了 false，怎么办？
可以用引号将 `'no'` 括起来强制声明为字符串，或者使用 `!!str no` 显式类型标注。
如何保持 YAML 中的注释不被删除？
本 Skill 在编辑和生成 YAML 时会保留所有注释，你也可以使用 `yq` 的 `-P` 选项或指定 `preserveComments` 参数。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/yaml-x-2/raw/index.md 读取 YAML 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/yaml-x-2/raw/index.md（查看排版版本）