SuperAPI AI 工具集

home-assistant-automation-scripts

办公与效率

查看项目

更新于 10-15 14:25

技能介绍

用途

该技能面向 Home Assistant 的自动化、脚本与蓝图编写与维护。当用户提出自动化或脚本语法、触发器(triggers)、条件(conditions)、动作(actions)、蓝图使用等需求时,可使用本技能。

主要能力

  • 判断请求属于实例特定配置还是通用语法问题。
  • 在起草配置前,先发现实体(entities)与服务(services)。
  • 当决策涉及模板、辅助元素(helpers)、自动化模式、实体/设备 ID 或重构现有配置时,遵循 home-assistant-best-practices 及其参考文档。
  • 提供最小、有效的 YAML/JSON 或工具驱动的变更。
  • 校验模板,并通过追踪(traces)与日志进行故障排查。

使用方式

技能提供了一套 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

适用场景

适用于需要编写、修改或调试 Home Assistant 自动化与脚本配置的场景,包括使用蓝图、处理模板、排查自动化运行问题,以及查询历史与统计数据。

限制

资料未提供关于收费、价格、平台支持范围或具体效果的信息,暂未提供。