Home Assistant 智能家居配置加速器 Skill 技能

技能简介

Home Assistant 是开源智能家居平台，支持接入数千种设备、品牌和服务。随着家庭自动化场景增多，automations.yaml、scripts.yaml、configuration.yaml、secrets.yaml 文件越来越庞大，YAML 语法错误、实体 ID 冲突、trigger/condition 混用等问题随之而来。一个缩进错误可能导致整条自动化失效，一次错误的 service 调用可能让空调在半夜全开。

本技能为 Claude Agent 提供 Home Assistant YAML 配置的规范化写作指南，覆盖自动化（Automation）、脚本（Script）、场景（Scene）、模板（Template）和蓝图（Blueprint）五类核心配置，附带 Lovelace 仪表盘和 YAML 本地验证工具的使用方法。技能还提供 secrets 管理、文件组织结构和团队协作规范，适合希望将 Home Assistant 配置工程化的用户。

核心能力

1. 五类核心 YAML 生成：自动化、脚本、场景、模板、蓝图，覆盖 Home Assistant 日常配置需求的全部场景，每类配置都提供符合 2024+ 最新语法的模板和详细注释。

2. 2024+ 最新语法支持：Home Assistant 在 2024 年对 trigger、condition、action 语法做了重大更新（如 Trigger ID 机制、Choose Actions 替代脚本序列），技能确保所有生成的配置使用当前推荐写法，不使用已废弃的旧语法。

3. Lovelace 仪表盘构建：提供实体卡片（Entities Card）、历史图表（History Graph）、比萨饼图（Picture Elements）等常用卡片类型的 YAML 示例，帮助用户构建可视化仪表盘。

4. 本地 YAML 验证：内置本地验证脚本，在不重启 Home Assistant 的情况下检查 YAML 语法错误、实体 ID 合法性、自动化重复规则等常见问题，避免因配置错误触发服务器重启。

5. Secrets 安全管理：指导将密码、令牌、经纬度、数据库路径等敏感信息迁移到 secrets.yaml 并通过 !secret 引用，防止敏感信息进入版本控制系统。

6. 蓝图（Blueprint）设计规范：将重复的自动化抽取为可复用蓝图，定义标准化的 input 接口，说明从现有自动化迁移到蓝图的工作步骤。

安装配置

1. 安装前提：目标机器需安装 Python 3.10+ 和 PyYAML（用于本地验证）。Home Assistant 本身运行在树莓派、NAS、Docker 或 HomeOS 等任意支持的平台。

2. 通过 Skillstore 安装：在 Claude Code 或 Agent 终端执行 npx skillstore add esjavadex/homeassistant-config，技能写入本地 .claude/skills/homeassistant-config 目录。

3. 连接验证（如需要）：技能本身不连接运行中的 Home Assistant 服务器，生成的配置需复制到配置目录后通过「开发者工具 → YAML → 检查自动化」验证。

使用步骤

1. 第一步：描述自动化目标 向 Agent 说明需求，如「当客厅人在场检测到 motion 时，打开走廊灯，5 分钟后若无新 motion 则关闭」。Agent 根据实体列表（用户需提供 entity ID）和目标场景生成符合语法的自动化 YAML。

2. 第二步：本地 YAML 验证 生成后运行技能提供的本地验证 Prompt，Agent 调用 PyYAML 检查语法、实体 ID 存在性、trigger/condition 合法性等常见错误，返回修正建议。

3. 第三步：复制到 Home Assistant 配置目录 用户将修正后的 YAML 复制到对应文件（automations.yaml / scripts.yaml 等），在 Home Assistant 开发者工具中点击「重新加载自动化」或重启核心。

4. 第四步：验证运行时行为 在 Home Assistant UI 的「自动化」标签页手动触发测试，观察日志中 trigger、condition、action 执行顺序是否与预期一致，有问题再回到第一步调整。

适用场景

1. 新用户学习 YAML 语法：刚接触 Home Assistant，面对官方文档复杂多样的写法不知从何入手，通过本技能提供的带注释模板快速建立正确认知，避免从 Stack Overflow 获取的过时写法。

2. 复杂自动化工程化：当家庭自动化超过 50 条时，手写 YAML 难以维护，将通用模式抽象为蓝图，减少重复配置，降低全局出错概率。

3. 多用户/多环境配置同步：团队或家庭多成员共享 Home Assistant，使用 secrets.yaml 和标准文件组织结构，确保每个人的配置分离但共享变量统一管理。

4. 智能家居系统迁移：更换 Home Assistant 版本或迁移到新服务器时，用技能的验证工具批量扫描现有配置，提前发现不兼容的旧语法，避免在新环境运行时踩坑。

适用人群

• Home Assistant 智能家居玩家，尤其是希望减少重复配置的进阶用户
• 需要在 Home Assistant 上构建家庭自动化方案的智能家居工程师
• 管理多用户 Home Assistant 实例、关注配置安全性的技术负责人
• 有一定 YAML 基础、希望将家庭自动化配置纳入版本管理的开发者

工作原理

本技能是一套结构化的 Prompt 模板库，包含各类配置的语法规范、注释模板和验证规则。Claude Agent 接收到用户的自动化需求后，根据技能内的模板生成 YAML 配置，内部嵌入了 2024+ 最新语法规则和常见错误模式的预防逻辑。所有 YAML 输出都附带逐行注释，说明每行配置的作用和可调整的参数范围。

官方链接

• Skill 主页：https://skillstore.io/skills/esjavadex-homeassistant-config
• 安装命令：npx skillstore add esjavadex/homeassistant-config
• GitHub 源码：https://github.com/ESJavadex/claude-homeassistant-plugins