用途:为编写或修改 Home Assistant(HA)自动化、脚本、辅助元素与设备控制提供规范与决策流程。核心原则是尽量使用 HA 原生构造,模板会绕过校验、运行时静默失败且难以调试。
主要能力:提供编号决策工作流。第 0 步为门禁,若改动涉及实体 ID 或跨组件引用(重命名实体、用辅助元素替换模板传感器、转换设备触发器、重构自动化),先阅读 references/safe-refactoring.md 完成影响分析、设备兄弟项发现与变更后验证。随后依次为:1)先查原生条件/触发器,如用 numeric_state 替代模板浮点比较、用 condition: and 替代多状态模板、用 condition: time 替代时间判断、用 wait_for_trigger 状态触发器替代 wait_template;2)先查内置辅助元素,如 min_max 汇总、group 分组、derivative 变化率、threshold 阈值、utility_meter 用量跟踪;3)选择正确的自动化模式,运动灯超时用 restart、顺序处理(门锁)用 queued、按实体独立动作用 parallel、一次性通知用 single;4)优先 entity_id 而非 device_id,例外是 Zigbee2MQTT 自动发现的设备触发器;5)Zigbee 按键/遥控器,ZHA 用带 device_ieee 的事件触发器,Z2M 用设备触发器或 mqtt 触发器。
参考文件按需查阅:safe-refactoring.md(实体重命名、辅助元素替换、触发器重构)、automation-patterns.md(原生条件、触发器类型、等待动作、自动化模式、ifthen 与 choose、触发器 ID)、helper-selection.md(数值聚合、变化率、时间跟踪、计数与计时、调度、实体分组、决策矩阵)、template-guidelines.md(何时适合用模板、模板传感器最佳实践、错误处理)、device-control.md(entity_id 与 device_id、服务调用、Zigbee 按键模式、按域模式)、examples.yaml(综合示例)。
限制:资料未提供安装命令、价格、平台支持范围或官方文档链接;具体参考文件内容仅列出章节名,未给出完整正文。