跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
效率与协作

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> or ha-nova relay core --method <METHOD> --path <PATH> --body-file <payload-file>
  • use --out <result-file> for large responses
  • treat inline -d as 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 /core POST may silently CREATE — read skills/ha-nova/relay-api.md → Write-Probing Asymmetry before any experimental write

Capability Map

FeatureStatusSkill
Automations CRUDCoveredread / write
Scripts CRUDCoveredread / write
Config ReviewCoveredreview
Helpers (9 storage + 12 config-entry)Coveredhelper
Entity SearchCoveredentity-discovery
Service CallsCoveredservice-call
Relay SetupCoveredonboarding
Dashboard / Lovelace (storage lifecycle, cards, resources)Covereddashboard
Scenes (storage CRUD)Coveredscene
History QueriesCoveredhistory
Logbook QueriesCoveredhistory
Statistics / Trend QueriesCoveredhistory
System Health / RepairsCoveredhealth
Logs / diagnostics (why a specific automation/script/device/integration failed: traces, error/system logs, root cause)Covereddiagnose
Media players (transport, volume, source, grouping, browsing, TTS announce)Coveredmedia
Notifications (targets, mobile-app sends, persistent notifications)Coverednotify
Actionable-notification callbacks (waiting for a button press)Covered for the durable pathwrite (an automation on mobile_app_notification_action)
Cameras (snapshot, stream URL, record)Coveredcamera
MQTT (bounded topic listening, discovery/debug info, publish)Coveredmqtt
Voice / Assist (utterance testing, pipelines, entity exposure, engine inventory)Coveredassist
Persons / Zones / TagsCoveredadmin
User accounts (list, create, delete — with owner/system guards)Coveredadmin
YAML-only configuration (template/REST/command-line sensors, packages, themes)Coveredyaml-config
Frontend themesCoveredyaml-config
External data stores (InfluxDB long-term history, Prometheus, ...)Coveredexternal-sources
Weather forecasts (weather.get_forecasts)Coveredservice-call
Calendar Events (read / create / update / delete)Coveredcalendar
Custom events / known JSON webhooksCoveredservice-call
Alarm / lock runtime controlCoveredservice-call
To-do Lists (items + Local To-do lifecycle)Coveredtodo
Area / Floor CRUDCoveredorganize
Label CRUD / Rich label metadataCoveredorganize
Category CRUD / Entity category assignmentCoveredorganize
Entity / Device metadata updatesCoveredorganize
BlueprintsRelay-Readythis skill
Energy (analysis + source/device config)Coveredenergy
Other Config-Entry HelpersRelay-Readythis skill
Statistics repair / Purge / Entity registry removeCoveredmaintenance
Device config-entry detachExternal-- (Home Assistant UI; HA 2026.8+ removes the device)
Integration onboarding (add / re-auth an integration via config flow)Coveredintegration-setup
Custom-integration configuration APIs — the integration's OWN endpoints (Alarmo, Scheduler, Frigate, ...)Relay-Readythis skill
Event capture — bounded window (a button's event, a short watch after an action)Relay-Readythis skill; mqtt for MQTT topics
Event streaming — continuousRoadmap Phase 1c--
Backups (status, create, inspect, delete)Coveredbackup
Config snapshots (targeted capture/restore of automations, scripts, scenes, dashboards, helpers, energy prefs, metadata, YAML files)Coveredthe owning family skill (see skills/ha-nova/config-snapshots.md)
Updates (pending, release notes, install, skip)Coveredupdates
Apps / Supervisor: install, uninstall, configure, storeExternal-- (updates: updates; start/stop/restart and host reboot: service-call)
HACS (registration, download, version switching, uninstall, migration)Coveredhacs
Zigbee / Z-Wave ConfigExternal-- (MQTT-level inspection of a Zigbee2MQTT setup: mqtt)
Zigbee / Z-Wave network status (read-only device list / network reads)Relay-Readythis skill; Z2M bridge topics: mqtt
Alarm / lock code management (lock user codes, alarm PINs)External-- (Home Assistant UI;
阅读完整来源 ↗