Skills

Diese Seite beschreibt, wie Skills im Workspace verwendet werden und welche Steuerungsmöglichkeiten aktuell verfügbar sind.

Grundprinzip

Ein Skill ist eine Arbeitsanweisung für wiederkehrende Aufgaben oder Domänen. Er beeinflusst, von welchen Dateien, Regeln und Prüfschritten der Assistent im Workspace ausgeht.

Zweck

Skills strukturieren wiederkehrende Aufgaben, damit der Assistent in ähnlichen Fällen nach denselben Vorgaben arbeitet.

Wirkung im Assistentenlauf

Skills priorisieren Einstiegspunkte, benennen relevante Regeln und grenzen Änderungswege ein, die vermieden werden sollen.

Sichtbarkeit im Workspace

Im Workspace erscheinen Produktskills und eigene Workspace-Skills gemeinsam. Je nach Freigabe können sie aktiviert, deaktiviert, bearbeitet oder zurückgesetzt werden.

Grenzen

Skills ändern nicht die fachliche oder technische Verantwortung. Ergebnisse müssen weiterhin geprüft und freigegeben werden.

Aktueller Funktionsumfang im Workspace

  • Die Skills-Seite zeigt Produktskills und eigene Workspace-Skills gemeinsam.
  • Der Aktivstatus einzelner Skills lässt sich direkt für den aktuellen Workspace umschalten.
  • Suche, Aktivstatus und Quelle können verwendet werden, um die sichtbare Ergebnismenge einzugrenzen.
  • Eigene Skills und freigegebene Produktskills lassen sich im Workspace bearbeiten.
  • Workspace-Skills können ergänzt werden, wenn zusätzliche Domänenhinweise oder Arbeitsregeln festgehalten werden sollen.
  • Bearbeitete Produktskills lassen sich auf den Produktstandard zurücksetzen. Eigene Workspace-Skills können entfernt werden.
  • Nach Aktivieren, Deaktivieren oder Neuanlegen eines Skills sollte der Chat neu gestartet werden, damit der Assistent mit dem aktuellen Skill-Stand arbeitet.

Beispiel: Workspace-Skill für einen Z-Service

Wenn ein Workspace den Service `ZUI_BILLING_APPROVAL_SRV` enthält und die Kernlogik in `ZCL_SD_BILLING_APPROVAL_SERVICE` liegt, kann ein eigener Skill diesen Einstiegspunkt und die zugehörigen Regeln festlegen.

Ausgangslage

Mehrere Aufgaben betreffen dieselbe fachliche Domäne: Genehmigungsregeln, Statuswechsel, Mapping oder Validierungen rund um einen bestimmten Z-Service.

Festgelegte Leitlinie

Der Skill legt fest, dass der Assistent von der zentralen Service-Klasse ausgeht, fachliche Regeln dort hält und sie nicht in UI-Handlern oder generischen Hilfsklassen verteilt.

Erwartete Auswirkung

Der Assistent beginnt an einem definierten Einstiegspunkt und bleibt bei Änderungen näher an den vorgesehenen Domänengrenzen.

Beispiel für einen eigenen Skill

---
name: sd-billing-approval-skill
description: Use when tasks affect billing approval behavior behind ZUI_BILLING_APPROVAL_SRV.
---

# SD Billing Approval

Use when tasks change approval checks, release rules, status transitions, or mappings behind `ZUI_BILLING_APPROVAL_SRV`.

Always start from `ZCL_SD_BILLING_APPROVAL_SERVICE` as the central domain service.
Keep approval rules and threshold logic in this service or its domain collaborators.
Do not move billing approval logic into UI handlers, RAP facades, or generic helper classes.
When changing behavior, also inspect:
- `ZIF_SD_BILLING_APPROVAL_TYPES`
- `ZCL_SD_BILLING_APPROVAL_REPOSITORY`
- `ZCL_SD_BILLING_APPROVAL_LOG`

Prefer extending the existing service flow over adding a parallel second implementation.

Das Beispiel zeigt, wie wiederkehrende Domänenvorgaben als Skill festgehalten werden können.