用途：校验 Home Assistant 配置文件，排查 YAML 语法错误与常见问题。适用场景包括检查 configuration.yaml 或 automations.yaml 的 YAML 语法、检测未定义的 !secret 引用、查找 scripts.yaml 或 scenes.yaml 中的重复键，以及在 Docker 或 HA OS 上运行配置校验。若是在编辑 configuration.yaml 添加或修改集成、向 secrets.yaml 添加新条目、把配置重组为 packages，或编写模板传感器与 recorder/logger 配置，则资料建议改用 ha-configuration。
主要能力与步骤：一是 YAML 语法校验，使用 python3 的 yaml.safe_load 遍历所有 YAML 文件并输出 OK 或 ERROR；二是常见问题检查，通过 grep 与 comm 对比已使用和已定义的 secret，检测未定义的 !secret，并用自定义 DuplicateKeyChecker 检测 configuration.yaml、automations.yaml、scripts.yaml、scenes.yaml 中的重复键；三是基于 Docker 的完整校验，执行 docker exec homeassistant hass --script check_config；四是 Home Assistant OS 校验，执行 ha core check。
使用方式：技能内使用 {{ path or '.' }} 作为配置路径占位符，并可用 !find 列出 YAML 文件。校验后应报告 YAML 语法错误（含文件与行号）、未定义的 secret 引用、重复键，并给出常见修复建议，如 found undefined alias 时在 secrets.yaml 补充条目、could not determine a constructor 时检查缩进、duplicate key 时删除或重命名重复键、expected <block end> 时修正缩进对齐、mapping values are not allowed 时在冒号后加空格。
限制：Docker 与 HA OS 两类完整校验仅在对应环境可用时执行；secret 与重复键检查针对脚本中列出的固定文件；资料未提供安装步骤、收费信息与执行效果保证。