Communitygithub.com

homeassistant-ai/home-assistant-最佳实践

用于 Home Assistant 自动化、辅助元素、脚本、控制和仪表板的最佳实践指南。当创建或编辑自动化、脚本、场景或仪表板时触发此技能。

home-assistant-最佳实践 是什麼?

此技能为使用 Home Assistant 的 AI 代理提供了一套全面的最佳实践指南,专注于自动化、辅助元素、脚本、控制和仪表板。它确保代理采用 Home Assistant 原生功能而非复杂的 Jinja2 模板,优先使用 entity_id 而非 device_id,并在修改实体 ID 前检查消费者。该技能指导如何选择模板传感器与内置辅助元素、重构触发器和条件、设置 Zigbee 按钮/远程自动化,以及正确配置仪表板卡片。它还防止代理编辑 .storage 文件、直接写入 YAML(UI 集成应避免此操作),或建议用户编辑 configuration.yaml。支持 AppDaemon 应用审核,并为专业 Home Assistant 用户强调标准惯例,如使用辅助元素而非硬编码值、采用正确的自动化模式(例如,单一、重启、队列),以及确保实体命名一致性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/homeassistant-ai/skills/tree/main/skills/home-assistant-best-practices

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

home-assistant-最佳实践 是做什麼的?

适用于 HA 自动化、辅助元素、脚本、控制和仪表板的最佳实践。触发此技能的场景:

  • 创建或编辑自动化、脚本、场景或仪表板
  • 在模板传感器与内置辅助元素之间进行选择
  • 重构触发器、条件或自动化模式
  • 设置 Zigbee 按钮/远程自动化
  • 重命名实体或将 device_id 迁移到 entity_id
  • 配置仪表板卡片或选择辅助元素
  • 查找卡片类型或领域文档
  • 编写或审核 AppDaemon 应用

症状:

  • 代理在存在原生选项时使用 Jinja2 模板
  • 代理使用 device_id 而非 entity_id
  • 代理在未检查消费者的情况下更改实体 ID
  • 错误的自动化模式
  • 代理硬编码值或使用原始传感器而非辅助元素
  • 代理编辑 .storage、编写 YAML 或生成 YAML 片段
  • 代理告诉用户编辑 configuration.yaml 以进行 UI 集成

相關技能