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 
 
 
 
 Skill 
 Zweck 
 Version 
 
 
 
 
 otris-filetype-basics 
 Mappentypen und Felder per Skript anlegen, ändern, löschen (otrUpgrade) 
 1.0 
 
 
 weitere folgen 
   
   
 
 
 
 Verwenden 
 
 Skill-Seite im Kapitel öffnen und Installationsanleitung befolgen (ZIP oder manuell). 
 VS Code neu laden. 
 Im Agent-Modus ganz normal die Aufgabe stellen. Der Skill wird bei Bedarf automatisch geladen. 
 
 Wo liegen Skills? 
 
 
 
 KI-Tool 
 Ordner im Projekt 
 
 
 
 
 GitHub Copilot (VS Code) 
 .github/skills/<skill-name>/ 
 
 
 Claude Code 
 .claude/skills/<skill-name>/ 
 
 
 
 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 
 
 
 
 Problem 
 Lösung 
 
 
 
 
 Skill wird nicht genutzt 
 Agent-Modus aktiv? Ordnername = name im Frontmatter? Zielordner korrekt? 
 
 
 Skill veraltet 
 Version auf der Skill-Seite prüfen, neues ZIP laden

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 
 
 
 
 Datei 
 Zweck 
 
 
 
 
 SKILL.md 
 Anleitung: Typings, Update-Skripte, Operationen, Spec-Keys, Stolperfallen 
 
 
 references/otrupgrade-api.md 
 Funktionsliste otrUpgrade (✅ = im Projekt geprüft, ⚪ = nur aus Typings bekannt) 
 
 
 
 Voraussetzungen 
 
 
 
 Voraussetzung 
 Details 
 
 
 
 
 VS Code Extension documentsOS 
 Typings installieren ( Install Typings ) 
 
 
 fileTypes.d.ts 
 Befehl Get File Type Typings , nach jeder Mappentyp-Änderung neu 
 
 
 jsconfig.json 
 Template der Extension (Pfade zu otrUpgrade) 
 
 
 KI mit Skills-Support 
 GitHub Copilot (Agent-Modus) oder Claude Code 
 
 
 
 Hinweise 
 
 Änderungen immer zuerst auf einem Testsystem prüfen. 
 Funktionen mit ⚪ vor dem Einsatz testen. 
 
 
 Installation 
 1. Zielordner wählen 
 
 
 
 KI-Tool 
 Ordner im Projekt 
 
 
 
 
 GitHub Copilot (VS Code) 
 .github/skills/otris-filetype-basics/ 
 
 
 Claude Code 
 .claude/skills/otris-filetype-basics/ 
 
 
 
 2. Dateien anlegen 
 Skill-Dateien als ZIP: otris-filetype-basics.zip 
 Variante A: ZIP (empfohlen) 
 
 ZIP otris-filetype-basics.zip von der Seite Übersicht herunterladen. 
 ZIP in den Zielordner entpacken ( .github/skills/ bzw. .claude/skills/ ). 
 Prüfen, dass die Struktur stimmt (siehe unten). 
 VS Code neu laden ( Developer: Reload Window ). 
 
 Variante B: Manuell 
 
 Ordner otris-filetype-basics im Zielordner anlegen (Name exakt so). 
 Darin SKILL.md anlegen, Inhalt von der Seite SKILL.md kopieren. 
 Unterordner references anlegen, darin otrupgrade-api.md mit dem Inhalt der Seite Referenz . 
 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 
 
 
 
 Problem 
 Lösung 
 
 
 
 
 Skill wird nicht gefunden 
 Ordnername ≠ name im Frontmatter, oder falscher Zielordner 
 
 
 Referenz wird nicht geladen 
 Datei muss in references/ liegen 
 
 
 Skill nicht aktiv (Copilot) 
 Agent-Modus verwenden, VS Code aktuell halten