Home Assistant 集成开发规范
给一个 Home Assistant 集成的代码,按项目规范审查目录结构、实体写法、质量等级规则和测试写法。
功能与用途
写 Home Assistant 集成有很多不成文的项目约定:轮询间隔不能做成用户可选项、配置流程里不能让用户自己起名、集成只该是薄封装而把协议解析放进独立的 PyPI 库、实体的加载与卸载行为必须对称。这些约定散在开发者文档各处,写错了在审查环节才被打回。这份参考把它们集中起来,还带上质量等级规则的逐条判定方式和测试写法要求,用来对照自查或在审查别人的集成时当作依据。
适用场景
- 正在给一个设备写 Home Assistant 集成,不确定:正在给一个设备写 Home Assistant 集成,不确定轮询和配置流程的写法是否违反项目约定
- 准备把集成提升到 gold 或 platinum 质量等级,:准备把集成提升到 gold 或 platinum 质量等级,需要逐条核对规则该标 done、exempt 还是 todo
- 审查别人提交的集成时,判断实体加载与卸载是否对称、有没有重复:审查别人提交的集成时,判断实体加载与卸载是否对称、有没有重复声明基类已有的方法
- 集成里为了绕开底层库的限制加了补丁逻辑,想知道项目规范是怎么:集成里为了绕开底层库的限制加了补丁逻辑,想知道项目规范是怎么要求的
适用人群
- Home Assistant 集成开发者
- home-assistant/core 的代码审查者
- 开发智能家居设备对接的嵌入式工程师
使用步骤
- 确认集成代码与测试的位置(components/<domain>/ 与 tests/components/<domain>/)
- 对照通用规范检查配置流程、实体平台写法和库分层是否符合项目约定
- 读 manifest.json 的 quality_scale 确定目标等级,再逐条判定质量等级规则的状态
- 按测试要求检查是否有 mock 集成内部细节的写法并修正
- 涉及 diagnostics 与 repairs 时另查对应的平台指引文件
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- dev
- 最近更新
- 2026-09-17
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
使用前准备
- 需要熟悉 Home Assistant 集成开发模型(manifest.json、config flow、entity platform、async 生命周期、独立 PyPI 库分层)并能访问其开发者文档。
依赖与权限
- 读取用户主动提供的内容