feat(skills): Skill entscheidet selbst ob vorgelesen wird (manifest.speak)

Verallgemeinert das "run_* → stumm"-Heuristik: jeder Skill deklariert im
Manifest ein speak-Flag.
- speak=false (Default) = Steuerbefehl (Spotify, Licht) → kein TTS, App
  beendet direkt (STOP), wie bisher.
- speak=true = Antwort-Skill (Info/Ergebnis) → Antwort wird vorgelesen +
  Gespraechs-Fenster bleibt offen.

Gilt für BEIDE Pfade: Fast-Path (_fast_path_speak aus skill.speak) und
lokale Skill-Ausführung (_local_turn_speak = _skill_speak_flag(run_*)).
Info-Tools (web_search/memory_search/trigger_timer) bleiben gesprochen.

- skills.py: speak in create_skill + update_skill-allowed.
- agent.py: skill_create/skill_update Tool-Schema dokumentiert speak (damit
  ARIA es beim Skill-Bau setzen kann), Dispatch reicht es durch.
- App: _isSilent nur noch speak===false (kein answeredBy=fast-path-Fallback
  mehr, sonst waere ein speak=true-Fast-Path faelschlich stumm).

Bestehende Skills ohne Feld = false = stumm (kein Verhaltenswechsel).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-11 21:39:55 +02:00
co-authored by Claude Opus 4.8
parent a9e1a46a2f
commit 2716bc62ff
3 changed files with 75 additions and 18 deletions
+61 -15
View File
@@ -234,6 +234,24 @@ META_TOOLS = [
"\"method\":\"PUT\"},\"reply\":\"Spotify: pausiert ⏸\"}]"
),
},
"speak": {
"type": "boolean",
"description": (
"Soll die Antwort dieses Skills VORGELESEN werden (TTS)? "
"Default false. \n"
"- false = reiner STEUERBEFEHL (Spotify next/pause, Licht, "
"Rollade): es gibt nichts vorzulesen, die App beendet direkt "
"und lauscht wieder aufs Wake-Word (knackig, wie ein "
"Kommando).\n"
"- true = ANTWORT-Skill: das Ergebnis ist eine Information, "
"die Stefan HOEREN will (z.B. ein Wuerfelergebnis, ein "
"Nachschlage-Wert, ein Status). Dann wird die Antwort "
"vorgelesen und das Gespraechs-Fenster bleibt offen.\n"
"Gilt fuer Fast-Path UND wenn das lokale LLM den Skill "
"aufruft. Im Zweifel bei Kommandos false, bei "
"Frage-Antwort-Skills true."
),
},
},
"required": ["name", "description", "entry_code"],
},
@@ -310,6 +328,13 @@ META_TOOLS = [
"wieder durch Claude). Wenn nicht angegeben: bleibt unberuehrt."
),
},
"speak": {
"type": "boolean",
"description": (
"Vorlesen ja/nein (siehe skill_create). false = "
"Steuerbefehl/stumm, true = Antwort-Skill/vorlesen."
),
},
},
"required": ["name"],
},
@@ -1154,6 +1179,8 @@ class Agent:
continue
args = pat.get("args") or {}
reply = pat.get("reply") or f"{skill_name}: ok"
# Vorlesen? Folgt dem Skill-Manifest (Default False=Steuerbefehl).
self._fast_path_speak = bool(skill.get("speak", False))
logger.info("[fast-path] match skill=%s pattern=%r msg=%r",
skill_name, rx, user_message[:60])
try:
@@ -1221,16 +1248,31 @@ class Agent:
break
return tools
def _skill_speak_flag(self, tname: str) -> bool:
"""speak-Flag eines run_*-Skills aus dem Manifest (Default False =
Steuerbefehl/stumm). Loest run_-Name → Skill fuzzy auf (Bindestriche)."""
if not tname.startswith("run_"):
return True
suffix = tname[len("run_"):]
m = skills_mod.read_manifest(suffix)
if m is None:
for cand in skills_mod.list_skills(active_only=False):
cn = cand.get("name") or ""
if re.sub(r"[^a-zA-Z0-9_]", "_", cn) == suffix:
m = cand
break
return bool((m or {}).get("speak", False))
def _try_local_fast_lane(self, user_message: str,
active_project_id: str) -> Optional[str]:
cfg = router_mod.load_config()
if not router_mod.should_try_local(user_message, cfg):
return None
# Merker: hat dieser lokale Turn einen echten Skill (run_*) ausgefuehrt?
# Dann ist es ein Steuerbefehl (z.B. Spotify) → NICHT vorlesen (speak=
# False), wie beim Fast-Path. Info-Tools (web_search/memory_search/
# trigger_timer) zaehlen NICHT — deren Antwort/Bestaetigung wird gesprochen.
self._local_turn_executed_skill = False
# Vorlesen ja/nein fuer diesen lokalen Turn. Default True (Info-Antwort).
# Fuehrt local einen Skill (run_*) aus, uebernimmt dessen speak-Flag aus
# dem Manifest (Steuerbefehl-Skill=False → stumm, Antwort-Skill=True).
# Info-Tools (web_search/memory_search/trigger_timer) lassen es bei True.
self._local_turn_speak = True
local_only = bool(cfg.get("localOnly"))
local_model = cfg.get("localLlmModel") or "qwen3-8b" # B0.5: llama-swap-Key
tools = self._build_local_tools() # B1b: kuratierte Tools
@@ -1278,10 +1320,11 @@ class Agent:
logger.info("[router] lokal Tool-Call: %s(%s)", tname,
", ".join(targs.keys()))
tresult = self._dispatch_tool(tname, targs)
# Echter Skill (run_*) ausgefuehrt = Steuerbefehl → nachher
# nicht vorlesen. Nur bei Erfolg (Fehler → eskaliert eh).
# Echter Skill (run_*) erfolgreich? Dann uebernimmt dieser
# Turn das speak-Flag des Skills (Steuerbefehl=stumm,
# Antwort-Skill=vorlesen). Letzter Skill gewinnt.
if tname.startswith("run_") and not self._local_tool_failed(tname, tresult):
self._local_turn_executed_skill = True
self._local_turn_speak = self._skill_speak_flag(tname)
if self._local_tool_failed(tname, tresult):
had_error = True
messages.append({"role": "tool",
@@ -1376,9 +1419,10 @@ class Agent:
metrics.log_fast_path(fast_reply)
except Exception:
pass
# Fast-Path = reiner Steuerbefehl → NICHT vorlesen (speak=False).
# System-Flag statt <voice>-Tag: robust, unabhaengig vom Skill-Inhalt.
return fast_reply, "fast-path", False
# Vorlesen folgt dem Skill-Manifest (speak): Steuerbefehl=stumm,
# Antwort-Skill=vorlesen. Default False (reiner Steuerbefehl).
speak = bool(getattr(self, "_fast_path_speak", False))
return fast_reply, "fast-path", speak
# 1. User-Turn an die Konversation
self.conversation.add("user", user_message, source=source,
@@ -1392,10 +1436,9 @@ class Agent:
# teure Claude-Aufbau + Tool-Loop wird uebersprungen. Sonst None → Claude.
local_reply = self._try_local_fast_lane(user_message, active_project_id)
if local_reply is not None:
# Hat local einen echten Skill (run_*) ausgefuehrt → Steuerbefehl,
# NICHT vorlesen (kein TTS, App beendet direkt statt 30s-Gespraech) —
# genau wie Fast-Path. Sonst normale gesprochene Antwort.
speak = not getattr(self, "_local_turn_executed_skill", False)
# speak folgt dem Skill: Steuerbefehl-Skill (speak=false) → stumm +
# App beendet direkt; Antwort-Skill/Info-Tool → vorlesen + Gespraech.
speak = getattr(self, "_local_turn_speak", True)
return local_reply, "local", speak
# 2. Hot Memory (alle pinned Punkte)
@@ -1618,6 +1661,7 @@ class Agent:
pip_packages=arguments.get("pip_packages", []),
config_schema=arguments.get("config_schema") or None,
fast_patterns=arguments.get("fast_patterns") or None,
speak=bool(arguments.get("speak", False)),
author="aria",
)
# Side-Channel-Event: Stefan soll sehen wenn ARIA was anlegt
@@ -1677,6 +1721,8 @@ class Agent:
for k in ("entry_code", "readme", "description", "args", "active"):
if k in arguments and arguments[k] is not None:
patch[k] = arguments[k]
if "speak" in arguments and arguments["speak"] is not None:
patch["speak"] = bool(arguments["speak"])
if "pip_packages" in arguments and isinstance(arguments["pip_packages"], list):
patch["pip_packages"] = arguments["pip_packages"]
if "config_schema" in arguments and isinstance(arguments["config_schema"], list):