# Arbeiten mit KI

Dieses Kapitel zeigt, wie du KI-Assistenten in VS Code für die Entwicklung und Konfiguration von DOCUMENTS-Systemen nutzt. Es erklärt, wie du die KI einrichtest, wiederverwendbare Skills einbindest und typische Aufgaben (z. B. Portalskripte schreiben, Skripte prüfen und dokumentieren) effizient erledigst. Außerdem findest du hier Hinweise, was du der KI anvertrauen darfst und was nicht.

# Skills

## Was sind Skills?

Ein Skill ist ein Ordner mit Anleitungen (`SKILL.md`) und optionalen Referenzdateien. Die KI lädt ihn automatisch, wenn die Aufgabe passt. So arbeitet sie nach unseren Standards, ohne dass du jedes Mal alles erklären musst.

## Skills im Überblick

<table border="1" id="bkmrk-skill-zweck-version-"><thead><tr><th>Skill</th><th>Zweck</th><th>Version</th></tr></thead><tbody><tr><td>otris-filetype-basics</td><td>Mappentypen und Felder per Skript anlegen, ändern, löschen (otrUpgrade)</td><td>1.0</td></tr><tr><td>*weitere folgen*</td><td> </td><td> </td></tr></tbody></table>

## Verwenden

1. Skill-Seite im Kapitel öffnen und Installationsanleitung befolgen (ZIP oder manuell).
2. VS Code neu laden.
3. Im **Agent-Modus** ganz normal die Aufgabe stellen. Der Skill wird bei Bedarf automatisch geladen.

## Wo liegen Skills?

<table border="1" id="bkmrk-ki-tool-ordner-im-pr"><thead><tr><th>KI-Tool</th><th>Ordner im Projekt</th></tr></thead><tbody><tr><td>GitHub Copilot (VS Code)</td><td>`.github/skills/<skill-name>/`</td></tr><tr><td>Claude Code</td><td>`.claude/skills/<skill-name>/`</td></tr></tbody></table>

Der Ordnername muss mit dem `name` im Frontmatter der `SKILL.md` übereinstimmen.

## Regeln

- Änderungen zuerst auf einem **Testsystem** prüfen.
- KI-Ergebnisse immer selbst prüfen, bevor sie auf Kundensystemen laufen.
- Keine Kundendaten, Zugangsdaten oder Secrets in Prompts oder Skills.
- Skills nicht lokal ändern. Verbesserungen an den Ersteller melden, damit alle profitieren.

## Probleme

<table border="1" id="bkmrk-problem-l%C3%B6sung-skill"><thead><tr><th>Problem</th><th>Lösung</th></tr></thead><tbody><tr><td>Skill wird nicht genutzt</td><td>Agent-Modus aktiv? Ordnername = `name` im Frontmatter? Zielordner korrekt?</td></tr><tr><td>Skill veraltet</td><td>Version auf der Skill-Seite prüfen, neues ZIP laden</td></tr></tbody></table>

# SKILL: otris File Type Basics

### Wann greift der Skill?

Mappentypen (File Types) per Skript anlegen, erweitern, ändern und löschen, mit dem offiziellen otris-Modul `otrUpgrade`.

- Mappentyp oder Felder per Skript anlegen oder ändern
- Register, Aktionen, Rechte, Kategorien, Ordner
- "Mappen ändern" (`submitFileChanges`)
- otr-package Update-Skripte oder PortalScript

Kein projektspezifischer Code, nur otris-Standard.

### Inhalt

<table border="1" id="bkmrk-datei-zweck-skill.md"><thead><tr><th>Datei</th><th>Zweck</th></tr></thead><tbody><tr><td>`SKILL.md`</td><td>Anleitung: Typings, Update-Skripte, Operationen, Spec-Keys, Stolperfallen</td></tr><tr><td>`references/otrupgrade-api.md`</td><td>Funktionsliste otrUpgrade (✅ = im Projekt geprüft, ⚪ = nur aus Typings bekannt)</td></tr></tbody></table>

### Voraussetzungen

<table border="1" id="bkmrk-voraussetzung-detail"><thead><tr><th>Voraussetzung</th><th>Details</th></tr></thead><tbody><tr><td>VS Code Extension **documentsOS**</td><td>Typings installieren (*Install Typings*)</td></tr><tr><td>`fileTypes.d.ts`</td><td>Befehl *Get File Type Typings*, nach jeder Mappentyp-Änderung neu</td></tr><tr><td>`jsconfig.json`</td><td>Template der Extension (Pfade zu otrUpgrade)</td></tr><tr><td>KI mit Skills-Support</td><td>GitHub Copilot (Agent-Modus) oder Claude Code</td></tr></tbody></table>

### Hinweise

- Änderungen immer zuerst auf einem **Testsystem** prüfen.
- Funktionen mit ⚪ vor dem Einsatz testen.

### Installation

#### 1. Zielordner wählen

<table border="1" id="bkmrk-ki-tool-ordner-im-pr"><thead><tr><th>KI-Tool</th><th>Ordner im Projekt</th></tr></thead><tbody><tr><td>GitHub Copilot (VS Code)</td><td>`.github/skills/otris-filetype-basics/`</td></tr><tr><td>Claude Code</td><td>`.claude/skills/otris-filetype-basics/`</td></tr></tbody></table>

#### 2. Dateien anlegen

Skill-Dateien als ZIP: [otris-filetype-basics.zip](https://docs.squeeze.one/attachments/2)

##### Variante A: ZIP (empfohlen)

1. ZIP **otris-filetype-basics.zip** von der Seite **Übersicht** herunterladen.
2. ZIP in den Zielordner entpacken (`.github/skills/` bzw. `.claude/skills/`).
3. Prüfen, dass die Struktur stimmt (siehe unten).
4. VS Code neu laden (*Developer: Reload Window*).

##### Variante B: Manuell

1. Ordner `otris-filetype-basics` im Zielordner anlegen (Name exakt so).
2. Darin `SKILL.md` anlegen, Inhalt von der Seite **SKILL.md** kopieren.
3. Unterordner `references` anlegen, darin `otrupgrade-api.md` mit dem Inhalt der Seite **Referenz**.
4. VS Code neu laden (*Developer: Reload Window*).

#### Erwartete Struktur (beide Varianten)

```
.github/skills/            (bzw. .claude/skills/)
└── otris-filetype-basics/
    ├── SKILL.md
    └── references/
        └── otrupgrade-api.md
```

**Achtung:** Beim Entpacken darf kein doppelter Ordner entstehen (`otris-filetype-basics/otris-filetype-basics/SKILL.md`). `SKILL.md` muss direkt im Ordner `otris-filetype-basics` liegen.

#### 3. Testen

Im Agent-Modus fragen: *"Wie lege ich per Update-Skript ein neues Feld an einem Mappentyp an?"* Die Antwort sollte `attachFieldToFileType` und `submitFileChanges` nennen.

#### Häufige Probleme

<table border="1" id="bkmrk-problem-l%C3%B6sung-skill"><thead><tr><th>Problem</th><th>Lösung</th></tr></thead><tbody><tr><td>Skill wird nicht gefunden</td><td>Ordnername ≠ `name` im Frontmatter, oder falscher Zielordner</td></tr><tr><td>Referenz wird nicht geladen</td><td>Datei muss in `references/` liegen</td></tr><tr><td>Skill nicht aktiv (Copilot)</td><td>Agent-Modus verwenden, VS Code aktuell halten</td></tr></tbody></table>