用途
该技能面向 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 自动化与脚本配置的场景,包括使用蓝图、处理模板、排查自动化运行问题,以及查询历史与统计数据。
限制
资料未提供关于收费、价格、平台支持范围或具体效果的信息,暂未提供。