mcpField
H
home-assistant-automation-scripts

home-assistant-automation-scripts

github.com/bradsjm其他46782 次安装16 周前更新
代码仓库

关于 home-assistant-automation-scripts

面向 Home Assistant 自动化与脚本工作的技能,覆盖实体和服务发现、配置编写、模板验证及运行排障。它列出 ha-mcp 工具,可用于检查和修改自动化、脚本及相关配置。

主要功能

  1. 01发现实体与服务
  2. 02读取和搜索现有配置
  3. 03创建或更新自动化与脚本
  4. 04验证模板并排查运行记录
  5. 05导入蓝图并查看历史数据

适用场景

  1. 01根据实例中的实体和服务编写自动化
  2. 02修改或重构现有脚本配置
  3. 03验证模板并检查自动化运行问题

MCP 相关

通过 ha-mcp 使用 Home Assistant 工具,包括实体与服务发现、配置读写、模板验证和运行排障。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-automation-scripts

安装后在 Claude Code 中输入/home-assistant-automation-scripts确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
DEBUG_WORKFLOWS.md
LIMITED_TEMPLATES.md
REFERENCE.md
TEMPLATE_ENTITY_GUIDE.md

详细介绍

Home Assistant 自动化与脚本

工作流

  • 判断请求是针对特定实例,还是关于通用语法。
  • 起草配置前,先发现实体和服务。
  • 如果涉及模板、辅助工具、自动化模式、实体/设备 ID 或重构现有配置,请遵循 home-assistant-best-practices 及其参考资料。
  • 提供最精简且有效的 YAML/JSON,或通过工具执行更改。
  • 验证模板,并使用跟踪记录和日志排查问题。

工具映射(ha-mcp)

  • 发现实体:ha_get_overview、ha_search_entities
  • 发现服务:ha_list_services
  • 检查现有配置:ha_config_get_automation、ha_config_get_script、ha_deep_search
  • 创建/更新自动化:ha_config_set_automation
  • 创建/更新脚本:ha_config_set_script
  • 蓝图:ha_get_blueprint、ha_import_blueprint
  • 验证模板:ha_eval_template
  • 排查运行情况:ha_get_automation_traces、ha_get_logbook
  • 历史记录/趋势:ha_get_history、ha_get_statistics

参考资料

所有参考文件均相对于此 SKILL.md 文件所在的位置。

  • 最佳实践:home-assistant-best-practices(参见其中的 references/automation-patterns.md、references/template-guidelines.md、references/helper-selection.md、references/device-control.md、references/safe-refactoring.md)
  • 受限模板:references/LIMITED_TEMPLATES.md
  • 调试工作流:references/DEBUG_WORKFLOWS.md
  • 模板实体:references/TEMPLATE_ENTITY_GUIDE.md
  • 其他说明:references/REFERENCE.md

评论

支持 Markdown