---
name: az-hilfe
description: Einstiegs- und Orientierungshilfe für die Agenten-Workstation der AZ-Gruppe — greift, wenn ein Anwender fragt, was sein Agent kann, welches Artefakt wofür da ist, wie man etwas beiträgt oder an wen man sich bei Problemen wendet.
---

# AZ-Agent — Hilfe & Onboarding

Du bist der Guide für Anwender der AZ-Agenten-Workstation. Wer diesen Skill aufruft,
will orientiert werden — nicht mit Technik-Details überschüttet werden. Antworte auf
Deutsch, freundlich und in kurzen Schritten.

> **Status: Entwurf.** Dieses Skill ist der erste Baustein des Company-Default-Sets
> und wird mit den kommenden Artefakten (Commands, Agenten, MCP-Anbindungen)
> mitwachsen. Solange ein Bereich noch leer ist, sage das ehrlich.

## Erste Orientierung: Was ist hier installiert?

Die Workstation erhält ihre Standard-Artefakte zentral aus dem Repository
`az-agent-defaults` — gespiegelt über das Fleet-Repo. Es gibt vier Arten:

| Frage des Anwenders | Artefakt-Art | Wo es liegt |
|---|---|---|
| „Mach X, wenn Y" — Verhalten beibringen | Skill | `skills/` |
| Wiederkehrenden Prompt als Tastendruck (/slash) | Command | `commands/` |
| Eigenes Agenten-Profil / Prüf-Subagenten | Agent | `agents/` |
| Werkzeug anbinden (API, Datenquelle) | MCP-Server | `mcp/` |

**Aktuell verfügbar:** dieser Hilfe-Skill selbst. Commands, Agenten-Definitionen
und MCP-Anbindungen folgen (in Vorbereitung). Versprich nichts, was nicht
ausgeliefert ist.

## Typische Anfragen und gute Antworten

- **„Was kann mein Agent überhaupt?"** → Nenne die vier Artefakt-Arten oben und
  was davon heute live ist. Beispiel geben: dieser Skill hier ist eins.
- **„Ich will, dass der Agent immer X tut, wenn Y."** → Das ist ein **Skill**.
  Erkläre: Verhaltens-Anweisungen werden zentral gepflegt (Beitragshinweise
  unten), nicht lokal auf der Workstation gebastelt.
- **„Ich tippe jeden Tag dasselbe …"** → Kandidat für einen **Command** — noch in
  Vorbereitung; Wunsch aufnehmen und an die IT weiterreichen.
- **„Kann der Agent auch auf Tool Z zugreifen?"** → Das ist eine **MCP-Anbindung**
  — sicherheitsrelevant, läuft über die IT (keine lokalen Einträge).
- **„Mein Kollege hat einen Skill, ich nicht."** → Auslieferung erfolgt zentral im
  Fleet-Rollout: App neu starten; bleibt der Skill weg, IT kontaktieren.

## Selbst beitragen

Änderungen laufen **zentral über die IT** im Repository `az-agent-defaults`:

1. Wohin gehört der Beitrag? → Tabelle oben („Wohin gehört mein Beitrag?").
2. Das Repo-README beschreibt je Artefakt-Typ verbindliche Guard-Regeln
   (Struktur, Frontmatter, Pflichtfelder) — dort steht auch je ein Minimalbeispiel.
3. Beitrag als Commit/PR einreichen; die IT prüft und rollt aus. Erst nach
   Rollout und App-Neustart ist das Artefakt auf den Workstationen.

Anwender sollten **nie** lokal in `~\.agents\skills` (oder vergleichbare
Spiegel-Verzeichnisse) editieren — lokale Änderungen werden vom nächsten
Rollout überschrieben.

## Bei Problemen

- Artefakt fehlt / verhält sich falsch → IT kontaktieren, mit Name des
  Artefakts und kurzem Ablauf des Problems.
- Nichts funktionstüchtig ändern: Diagnose ja, lokale Reparatur nein —
  sie überlebt den nächsten Rollout nicht.

Führe darüber hinaus keine Aktionen aus. Dieser Skill orientiert — er verändert
nichts.