Home Assistant Manager 技能
一个 Claude Code 技能，让 Claude 成为家庭自动化专家：安全部署配置、验证自动化、并快速构建平板优化的 Lovelace 仪表盘。
README 声称『始终先验证再应用』和 reload-vs-restart 判断，但核心 SKILL.md 未随附，无法核实这些安全纪律是否真实存在于提示词中。工作流要求 SSH root 访问（示例用 [email protected]）、scp 部署和修改 .storage/，权限面较大且未见最小权限或用户确认协议；HASS_TOKEN 以环境变量传递，缺少泄露防护说明。仅扣分点均有出处：root SSH、直接写 .storage、无确认/回滚流程文档。作者署名与 MIT 许可使 source_attribution 得 2 分（发布者身份未经验证，按规则不再加分）。
前置条件（hass-cli、SSH 密钥、HASS_SERVER/HASS_TOKEN、可选 Context7 MCP）写得很清楚，dependency_availability 可得 2 分。但 README 自称的验证协议、日志分析模式、错误检测均无法在提供的文件中核对（SKILL.md 缺失），self_consistency 与 failure_messages 只能按声明计 1 分。
受众与场景描述充分（自动化开发、平板仪表盘、模板调试、运维排障），MCP 服务器对比一节明确划定了能力边界（无 MCP 时回退到 SSH/hass-cli），故分别给 3 与 2。但技能何时触发、触发条件的精确度完全取决于未提供的 SKILL.md frontmatter，trigger_precision 仅 1。环境要求（SSH root、git 化的 /config）描述清楚但假设较强，environment_fit 给 2。
安装说明是本仓库最强项：三种安装途径、市场斜杠命令、验证步骤齐备，得 3 分；许可为完整 MIT 文本，得 3 分。仓库结构、命名一致（home-assistant-manager），维护者署名、Issue/Discussion 渠道和贡献指南存在，各给 2。缺失项明确：无已知限制章节（1），且全库未见任何版本号或 CHANGELOG（0）。
README 给出三类可复现的使用示例和清晰的工作流叙述，产出可用性与边际价值（面向 HA 的专用流程知识而非通用 git 指南）合理估计为 2 分；但这些均为声明而非可验证产物，不能给满分。
所有效果性声明（视频演示、生产仪表盘案例、验证协议）指向未随附的 SKILL.md 与外部视频，claim_traceability 仅 1；无任何第二来源可交叉印证（0）；事实与推断基本分得开但示范不足（1）。
- 核心技能内容 SKILL.md 未在本次评审范围内提供，所有安全与流程声明均无法静态核实，请自行审查其提示词后再安装。
- 示例使用 root SSH 连接 Home Assistant 并直接写入 .storage/，权限过大；建议在隔离环境中先试用，并为配置目录准备独立备份。
- HASS_TOKEN 为长期有效访问令牌，README 未提供令牌轮换、作用域限制或防泄露建议，请注意保护该凭据。
- 该仓库无版本号与变更日志，插件市场更新无法审计增量变化，升级前请 diff 检查。
- 发布者身份未经企业注册表验证，仅为个人维护者，请勿在生产环境未经测试前依赖。
这个 Agent 能做什么，适合哪些场景？
该仓库（komal-SkyNET/claude-skill-homeassistant）是一个遵循官方 Claude 技能规范的 Claude Code 技能，同时也可作为自托管插件市场使用。它将 Claude 变成家庭助手配置专家，覆盖三大领域：通过 SSH 和 hass-cli 的远程访问、部署工作流（git 用于最终变更、scp 用于快速迭代、智能区分重载与重启），以及 Lovelace 仪表盘开发。该技能始终在应用前验证配置，默认编写现代自动化 YAML 语法（triggers:/conditions:/actions:），并通过手动触发自动化后检查日志和追踪结果来完成验证闭环。它通过 .claude/skills 目录或插件市场命令安装到用户的 Home Assistant 配置仓库中运行，可选集成 Context7 MCP 以获取官方文档。它不提供实时设备控制工具——那是 MCP 服务器的职责——而是编码操作规程与判断力。
该技能指导 Claude 执行完整的 Home Assistant 配置管理流程：读取用户的 /config 仓库，生成符合 2024.10+ 现代语法（triggers:/conditions:/actions:，用 action: 而非 service:）的自动化 YAML，通过 scp 部署变更实现即时测试，并根据变更类型决定调用重载还是重启。部署前会先验证配置以防止停机；部署后通过手动触发自动化、用 hass-cli 检查日志和追踪来验证执行结果（包括 automation.trigger 跳过条件这一陷阱）。对于仪表盘，它在 .storage/ 中创建仪表盘文件并在 lovelace_dashboards 中注册，使用 Mushroom/Tile/Template 等卡片和 Jinja2 模板（如门窗计数着色、基于时间/状态的条件显示）构建适配 7"/11"/13" 平板的触控友好布局，仪表盘变更只需刷新浏览器即可生效。当工作稳定后提交到 git。远程操作通过 SSH 执行 ha CLI 命令，并通过 HASS_SERVER 和 HASS_TOKEN 环境变量连接 hass-cli。
- 家庭自动化爱好者使用 Claude Code，需要快速开发并验证自动化（如前门开超过 5 分钟发送通知），而不想重启整个 HA 实例
- 拥有壁挂平板（7"/11"/13"）的用户，需要构建触控友好、颜色编码状态的 Lovelace 仪表盘
- 遇到模板类型错误（如比较 str 和 int 的 TypeError）的用户，需要系统化的日志分析、修复和重新验证流程
- 用 git 管理 HA 配置的开发者，希望结合 scp 快速迭代与 git 版本控制的混合部署工作流
- 担心 LLM 生成已弃用自动化语法的用户，需要强制使用现代 2024.10+ YAML 语法
- 已安装 HA MCP 服务器的用户，希望补充 Claude 在配置操作上的规程判断（验证后再重启、日志验证闭环）
这个 Agent 有哪些优点和局限？
- 强制使用现代自动化语法（triggers:/conditions:/actions:），避免 LLM 常见的已弃用 service: 语法
- 内置完整验证协议：手动触发自动化、检查日志和追踪，并覆盖 automation.trigger 跳过条件这一已知陷阱
- 智能重载 vs 重启决策加上先验证后应用纪律，降低配置错误导致停机的风险
- 与 MCP 服务器互补且可组合：技能优先使用 MCP 工具做实时状态与服务调用，无 MCP 时回退到 SSH/hass-cli
- 仪表盘变更通过 scp 部署后仅需浏览器刷新即可生效，无需重启，迭代速度快
- 附带来自真实生产平板仪表盘的可用示例和 Jinja2 模板
- 依赖 Claude Code 运行时，不适用于其他 AI 编码工具或聊天界面
- 要求 HA 实例启用 SSH 访问（通常需 root 权限）且 /config 已是 git 仓库，对托管或受限安装可能不可行
- 需要本地安装 hass-cli 并配置 HASS_SERVER/HASS_TOKEN 长期访问令牌，环境设置步骤较多
- 不提供实时设备控制能力，需要另行安装 MCP 服务器才能读取实体状态或调用服务
- Context7 MCP 文档集成需要额外的 API 密钥
- README 未提供版本发布、测试套件或独立于作者环境的采用证据
如何安装或部署这个 Agent？
前置条件：已安装并配置 Claude Code；Home Assistant 实例已启用 SSH 访问且 /config 目录已连接 git 仓库；本地安装 hass-cli（pipx install homeassistant-cli）；配置 SSH 密钥认证；设置环境变量 HASS_SERVER 和 HASS_TOKEN。
推荐方式（插件市场，两条斜杠命令，任意目录运行）：
/plugin marketplace add komal-SkyNET/claude-skill-homeassistant
/plugin install home-assistant-manager@claude-skill-homeassistant方式二（克隆到 HA 配置仓库）：
cd /path/to/your/homeassistant/config
mkdir -p .claude/skills && cd .claude/skills
git clone [email protected]:komal-SkyNET/claude-skill-homeassistant.git home-assistant-manager-repo
ln -s home-assistant-manager-repo/skills/home-assistant-manager home-assistant-manager方式三（下载解压）：
cd /path/to/your/homeassistant/config
mkdir -p .claude/skills/home-assistant-manager && cd .claude/skills/home-assistant-manager
curl -L https://github.com/komal-SkyNET/claude-skill-homeassistant/archive/main.tar.gz | tar xz --strip-components=2 claude-skill-homeassistant-main/skills/home-assistant-manager验证：运行 /plugin 确认 home-assistant-manager 已列出并启用；或启动 Claude Code 时技能自动加载。
如何使用这个 Agent？
在 Home Assistant 配置仓库目录中启动 Claude Code，技能自动加载。直接用自然语言下达任务，例如："创建一个自动化，当前门开超过 5 分钟时发送通知"——Claude 会生成 YAML、scp 部署、重载自动化、手动触发测试、检查日志、验证后提交 git。或 "为客厅 11 寸平板创建一个包含灯光、温控器和门窗状态的仪表盘"——Claude 会在 .storage/ 创建仪表盘、注册 lovelace_dashboards、使用三列网格和 Mushroom 卡片，scp 部署后即时预览。可选增强：安装 hass-cli 并导出 HASS_SERVER/HASS_TOKEN，配置 SSH（ssh [email protected] "ha core info" 测试），以及通过 claude mcp add --transport http context7 https://mcp.context7.com/mcp 添加 Context7 MCP 获取官方文档。
这个 Agent 与同类方案有什么区别？
与 Home Assistant MCP 服务器（官方 mcp_server 集成或社区 ha-mcp）的关系：MCP 服务器为 Claude 提供实时工具（读取实体状态、调用服务、控制设备），但不教 Claude 如何操作配置；本技能编码的是规程与判断——git/scp 部署管线、重载 vs 重启决策、先验证后重启纪律、基于日志和追踪的验证闭环、模板类型安全规则、仪表盘存储缓存陷阱以及现代自动化语法。没有技能时，配备 MCP 的 Claude 可以开关灯，但仍可能在未验证的配置上重启 HA 或写出已弃用的 YAML；没有 MCP 时，本技能回退到 SSH/hass-cli。两者组合使用效果最佳。