fallback
Mandatory fallback for any HA NOVA task without a dedicated subskill. Must be invoked before any raw relay write operation. Covers blueprints, device config-entry detach, Apps, Zigbee/Z-Wave, and unsupported config-entry helper families.
markusleben · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add markusleben/ha-nova --skill fallback技能说明
name: fallback description: Mandatory fallback for any HA NOVA task without a dedicated subskill. Must be invoked before any raw relay write operation. Covers blueprints, device config-entry detach, Apps, Zigbee/Z-Wave, and unsupported config-entry helper families. license: MIT compatibility: Requires the ha-nova CLI (run 'ha-nova setup' first) and the HA NOVA Relay in Home Assistant (App, or standalone container on Container/Core).
HA NOVA Fallback
Scope
Mandatory fallback for HA features without a dedicated skill. Three tiers:
- Relay-Ready: API works via Relay, no skill yet -- provide experimental relay calls with safety guardrails.
- Roadmap: Planned for future Relay phases -- explain timeline + workaround.
- External: Outside HA NOVA scope -- web search + HA UI pointer.
All relay calls in this skill are experimental -- always follow the Safety section below.
Bootstrap (before Home Assistant tasks)
Read and follow ../ha-nova/session-bootstrap.md before the first
Home Assistant or Relay-Ready task in this session.
Relay health is needed only when executing experimental relay calls, not for
Roadmap/External guidance.
Verify relay CLI: ha-nova relay health
If this fails: ha-nova setup
Relay Contract
For every Relay-Ready call in this skill:
- write request JSON with the client's native file-writing tool
- use
ha-nova relay ws --data-file <payload-file>orha-nova relay core --method <METHOD> --path <PATH> --body-file <payload-file> - use
--out <result-file>for large responses - treat inline
-das an optional tiny diagnostic path, not the canonical contract - transports diverge on empty write bodies: WS validates missing required fields fail-closed, but a parameterless WS write executes on its bare
type, and/corePOST may silently CREATE — readskills/ha-nova/relay-api.md→ Write-Probing Asymmetry before any experimental write
Capability Map
| Feature | Status | Skill |
|---|---|---|
| Automations CRUD | Covered | read / write |
| Scripts CRUD | Covered | read / write |
| Config Review | Covered | review |
| Helpers (9 storage + 12 config-entry) | Covered | helper |
| Entity Search | Covered | entity-discovery |
| Service Calls | Covered | service-call |
| Relay Setup | Covered | onboarding |
| Dashboard / Lovelace (storage lifecycle, cards, resources) | Covered | dashboard |
| Scenes (storage CRUD) | Covered | scene |
| History Queries | Covered | history |
| Logbook Queries | Covered | history |
| Statistics / Trend Queries | Covered | history |
| System Health / Repairs | Covered | health |
| Logs / diagnostics (why a specific automation/script/device/integration failed: traces, error/system logs, root cause) | Covered | diagnose |
| Media players (transport, volume, source, grouping, browsing, TTS announce) | Covered | media |
| Notifications (targets, mobile-app sends, persistent notifications) | Covered | notify |
| Actionable-notification callbacks (waiting for a button press) | Covered for the durable path | write (an automation on mobile_app_notification_action) |
| Cameras (snapshot, stream URL, record) | Covered | camera |
| MQTT (bounded topic listening, discovery/debug info, publish) | Covered | mqtt |
| Voice / Assist (utterance testing, pipelines, entity exposure, engine inventory) | Covered | assist |
| Persons / Zones / Tags | Covered | admin |
| User accounts (list, create, delete — with owner/system guards) | Covered | admin |
| YAML-only configuration (template/REST/command-line sensors, packages, themes) | Covered | yaml-config |
| Frontend themes | Covered | yaml-config |
| External data stores (InfluxDB long-term history, Prometheus, ...) | Covered | external-sources |
Weather forecasts (weather.get_forecasts) | Covered | service-call |
| Calendar Events (read / create / update / delete) | Covered | calendar |
| Custom events / known JSON webhooks | Covered | service-call |
| Alarm / lock runtime control | Covered | service-call |
| To-do Lists (items + Local To-do lifecycle) | Covered | todo |
| Area / Floor CRUD | Covered | organize |
| Label CRUD / Rich label metadata | Covered | organize |
| Category CRUD / Entity category assignment | Covered | organize |
| Entity / Device metadata updates | Covered | organize |
| Blueprints | Relay-Ready | this skill |
| Energy (analysis + source/device config) | Covered | energy |
| Other Config-Entry Helpers | Relay-Ready | this skill |
| Statistics repair / Purge / Entity registry remove | Covered | maintenance |
| Device config-entry detach | External | -- (Home Assistant UI; HA 2026.8+ removes the device) |
| Integration onboarding (add / re-auth an integration via config flow) | Covered | integration-setup |
| Custom-integration configuration APIs — the integration's OWN endpoints (Alarmo, Scheduler, Frigate, ...) | Relay-Ready | this skill |
| Event capture — bounded window (a button's event, a short watch after an action) | Relay-Ready | this skill; mqtt for MQTT topics |
| Event streaming — continuous | Roadmap Phase 1c | -- |
| Backups (status, create, inspect, delete) | Covered | backup |
| Config snapshots (targeted capture/restore of automations, scripts, scenes, dashboards, helpers, energy prefs, metadata, YAML files) | Covered | the owning family skill (see skills/ha-nova/config-snapshots.md) |
| Updates (pending, release notes, install, skip) | Covered | updates |
| Apps / Supervisor: install, uninstall, configure, store | External | -- (updates: updates; start/stop/restart and host reboot: service-call) |
| HACS (registration, download, version switching, uninstall, migration) | Covered | hacs |
| Zigbee / Z-Wave Config | External | -- (MQTT-level inspection of a Zigbee2MQTT setup: mqtt) |
| Zigbee / Z-Wave network status (read-only device list / network reads) | Relay-Ready | this skill; Z2M bridge topics: mqtt |
| Alarm / lock code management (lock user codes, alarm PINs) | External | -- (Home Assistant UI; |