Back to Details

home-assistant-automation-scripts

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Home Assistant Automations & Scripts

Home Assistant 自动化与脚本

Workflow

工作流

  • Determine whether the request is instance-specific or general syntax.
  • Discover entities and services before drafting config.
  • When decisions involve templates, helpers, automation modes, entity/device IDs, or refactoring existing config, follow 
    home-assistant-best-practices
    and its references.
  • Provide minimal, valid YAML/JSON or tool-driven changes.
  • Validate templates and troubleshoot with traces and logs.
  • 判断请求是针对特定实例还是通用语法问题。
  • 在编写配置前，先发现实体和服务。
  • 当涉及模板、辅助工具、自动化模式、实体/设备ID或重构现有配置的决策时，请遵循
    home-assistant-best-practices
    及其参考文档。
  • 提供简洁、有效的YAML/JSON配置或工具驱动的变更方案。
  • 通过追踪记录和日志验证模板并排查问题。

Tooling map (ha-mcp)

工具映射（ha-mcp）

  • Discover entities: 
    ha_get_overview
    , 
    ha_search_entities
  • Discover services: 
    ha_list_services
  • Inspect existing: 
    ha_config_get_automation
    , 
    ha_config_get_script
    , 
    ha_deep_search
  • Create/update automation: 
    ha_config_set_automation
  • Create/update script: 
    ha_config_set_script
  • Blueprints: 
    ha_get_blueprint
    , 
    ha_import_blueprint
  • Validate templates: 
    ha_eval_template
  • Troubleshoot runs: 
    ha_get_automation_traces
    , 
    ha_get_logbook
  • History/trends: 
    ha_get_history
    , 
    ha_get_statistics
  • 发现实体：
    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

References

参考文档

All reference files are relative to the location of this SKILL.md file.
  • Best practices: 
    home-assistant-best-practices
    (see its 
    references/automation-patterns.md
    , 
    references/template-guidelines.md
    , 
    references/helper-selection.md
    , 
    references/device-control.md
    , 
    references/safe-refactoring.md
    )
  • Limited templates: 
    references/LIMITED_TEMPLATES.md
  • Debug workflows: 
    references/DEBUG_WORKFLOWS.md
  • Template entities: 
    references/TEMPLATE_ENTITY_GUIDE.md
  • Additional notes: 
    references/REFERENCE.md
所有参考文件均相对于本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