Communitygithub.com

homeassistant-ai/home-assistant-best-practices

Home Assistant 自动化、助手、脚本、控制和仪表盘的最佳实践指南。

home-assistant-best-practices 是什么?

此技能为 AI 代理提供了一套在 Home Assistant 中创建和编辑自动化、脚本、场景和仪表盘时的最佳实践。它帮助代理避免常见陷阱,例如在不必要的地方使用 Jinja2 模板、错误地使用 `device_id` 而非 `entity_id`,或硬编码值而不是利用内置助手。该技能适用于所有主要的 AI 代理平台,如 Claude Code、Cursor 和 Codex,并指导代理选择正确的自动化模式、正确重命名实体以及为仪表盘配置合适的卡片类型。通过遵循这些指南,AI 代理可以生成更健壮、可维护且符合 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-best-practices 是做什么的?

Home Assistant 自动化、助手、脚本、控制和仪表盘的最佳实践。触发此技能的时机:

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

症状:

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

相关技能