SuperAPI AI 工具集

ha-quality-review

测试与质量

查看项目

更新于 10-15 23:48

技能介绍

ha-quality-review 用于按 Home Assistant 官方集成质量量表(IQS)系统审查某个 Home Assistant 集成。运行命令为 /home-assistant-dev:ha-quality-review。

用途:对照全部 52 条官方规则评估集成质量,IQS 分为四档:Bronze 18 条(新核心集成的最低要求)、Silver 10 条(可靠性与可维护性)、Gold 21 条(最佳用户体验)、Platinum 3 条(技术卓越)。

主要能力:审查流程包括定位集成目录(custom_components/{domain}/ 或 homeassistant/components/{domain}/)、尽可能运行自动化检查、按清单人工复核、生成含发现的报告。检查项覆盖代码组织(如 action-setup、common-modules、runtime-data)、配置流程(config-flow、test-before-configure、unique-config-entry)、实体(unique_id、has-entity-name、event-setup)、设置与可靠性(test-before-setup、appropriate-polling)、文档与品牌,以及 Silver 的错误处理、生命周期、性能、维护(test-coverage 要求超过 95%)、Gold 的设备与实体、发现、高级流程、诊断、翻译、文档,Platinum 的异步依赖、注入 websession、strict-typing。

用法:可按资料提供的快速校验命令检查 JSON、搜索常见问题并运行 linter,例如 python3 -c "import json; json.load(open('manifest.json'))"、grep -r "hass.data[DOMAIN]" .、ruff check .、mypy .。输出报告包含各档通过数、当前等级、必须修复项、警告、下一档建议和正面发现。

适用场景:审查或改进 Home Assistant 社区集成与核心集成,准备晋级 IQS 等级。相关技能包括 ha-config-flow、ha-coordinator、ha-entity-platforms、ha-async-patterns、ha-diagnostics、ha-hacs。限制:资料未提供安装方式、收费、价格与平台信息;规则细节与输出字段以官方 IQS 为准。