SuperAPI AI 工具集

homeassistant-yaml-dry-verifier

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

用途:在编辑 Home Assistant YAML 前后检查重复逻辑,发现冗余的 trigger/condition/action/sequence 结构,并推动把重复块重构为可复用的 script、helper 或 template。

主要能力:按 FULL_BLOCK(整块重复)、ENTRY(块内条目重复)、INTRA(单块内重复)、CENTRAL_SCRIPT(脚本定义在 config/packages 却被 2 个以上 YAML 文件调用)分类报告;输出扫描文件数、解析错误、重复分组及每组的具体重构建议;--strict 时任何发现都返回非零退出码,不加则仅在解析错误时非零。

使用方式:对已编辑文件运行 python codex_skills/homeassistant-yaml-dry-verifier/scripts/verify_ha_yaml_dry.py config/packages/life360.yaml --strict;清理时可扫描目录 python codex_skills/homeassistant-yaml-dry-verifier/scripts/verify_ha_yaml_dry.py config/packages config/automations。默认 --min-occurrences 2。重构后需重跑校验并执行 Home Assistant 配置检查。

适用场景:YAML 自动化、脚本、包文件的 DRY 清理与重构;仪表盘或自动化快速改动后排查新引入的重复逻辑。

限制与安全:实体/注册表安全检查保持只读,不删除注册表条目;涉及清理、删除等破坏性维护时要求预览/试运行、显式确认与审计备份;automation、script、scene、template、input_* 等平台常为误报来源,不可仅凭 unavailable 或 disabled 判定可删除。未解决的 FULL_BLOCK/ENTRY/CENTRAL_SCRIPT 及陈旧引用问题视为未完成,除非记录阻塞原因。更多重构模式见 references/refactor_playbook.md。