AI Skill 大全

Home Assistant 集成开发规范

给一个 Home Assistant 集成的代码,按项目规范审查目录结构、实体写法、质量等级规则和测试写法。

功能与用途

写 Home Assistant 集成有很多不成文的项目约定:轮询间隔不能做成用户可选项、配置流程里不能让用户自己起名、集成只该是薄封装而把协议解析放进独立的 PyPI 库、实体的加载与卸载行为必须对称。这些约定散在开发者文档各处,写错了在审查环节才被打回。这份参考把它们集中起来,还带上质量等级规则的逐条判定方式和测试写法要求,用来对照自查或在审查别人的集成时当作依据。

适用场景

  • 正在给一个设备写 Home Assistant 集成,不确定:正在给一个设备写 Home Assistant 集成,不确定轮询和配置流程的写法是否违反项目约定
  • 准备把集成提升到 gold 或 platinum 质量等级,:准备把集成提升到 gold 或 platinum 质量等级,需要逐条核对规则该标 done、exempt 还是 todo
  • 审查别人提交的集成时,判断实体加载与卸载是否对称、有没有重复:审查别人提交的集成时,判断实体加载与卸载是否对称、有没有重复声明基类已有的方法
  • 集成里为了绕开底层库的限制加了补丁逻辑,想知道项目规范是怎么:集成里为了绕开底层库的限制加了补丁逻辑,想知道项目规范是怎么要求的

适用人群

  • Home Assistant 集成开发者
  • home-assistant/core 的代码审查者
  • 开发智能家居设备对接的嵌入式工程师

使用步骤

  1. 确认集成代码与测试的位置(components/<domain>/ 与 tests/components/<domain>/)
  2. 对照通用规范检查配置流程、实体平台写法和库分层是否符合项目约定
  3. 读 manifest.json 的 quality_scale 确定目标等级,再逐条判定质量等级规则的状态
  4. 按测试要求检查是否有 mock 集成内部细节的写法并修正
  5. 涉及 diagnostics 与 repairs 时另查对应的平台指引文件

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
专业
版本
dev
最近更新
2026-09-17
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

使用前准备

  • 需要熟悉 Home Assistant 集成开发模型(manifest.json、config flow、entity platform、async 生命周期、独立 PyPI 库分层)并能访问其开发者文档。

依赖与权限

  • 读取用户主动提供的内容

同类 Skill