# AI Support - Prompts, Steering Files & Skills Sammlung von Prompts, Steering-Dateien und Skills für die Arbeit mit AI-Assistenten und LLMs. ## Inhaltsverzeichnis - [Überblick](#überblick) - [Struktur](#struktur) - [Steering Files](#steering-files) - [Prompts](#prompts) - [Skills](#skills) - [Verwendung](#verwendung) - [Beitragen](#beitragen) ## Überblick Dieses Repository enthält wiederverwendbare Bausteine für die effektive Nutzung von AI-Assistenten wie Kiro: - **Steering Files** — kontextuelle Anleitung, die in Sessions automatisch oder manuell eingebunden wird - **Prompts** — fertige Prompt-Vorlagen für wiederkehrende Aufgaben - **Skills** — abgeschlossene, ausführbare Pakete mit Workflow, Assets und Code (z. B. PowerPoint-Generator) Alle Bausteine sind so strukturiert, dass sie einfach in verschiedene Projekte übernommen werden können. ## Struktur ``` . ├── steering/ # Steering-Dateien für AI-Assistenten │ ├── agent-behaviour.md # Grundlegende Verhaltensregeln │ ├── codebase-summary.sop.md # SOP für Codebase-Dokumentation │ ├── einfachbahn-naming.md # Schreibweise #Einfachbahn (always) │ └── onboarding-dokumentation.md # Onboarding-Dokumentation erstellen ├── powers/ # Kiro Powers (on-demand Plattformwissen) │ ├── db-dxp-platform/ # DXP-Ökosystem-Nachschlagewerk │ ├── db-openshift-deploy/ # Manuelles OpenShift-Deployment │ ├── db-pipeship-onboarding/ # pipeship CI/CD Setup │ └── db-scm-info-compliance/ # scm-info.yaml + Compliance Suite ├── prompts/ # Wiederverwendbare Prompts │ └── unit-tests-motivation.md # Anleitung für Unit-Test-Erstellung ├── skills/ # Self-contained Skills (Workflow + Assets + Code) │ └── pptx-infrago/ # PowerPoint im DB InfraGO Corporate Design └── README.md ``` ## Steering Files Steering-Dateien bieten kontextuelle Anleitung für AI-Assistenten während der gesamten Interaktion. ### agent-behaviour.md Grundlegende Verhaltensregeln für AI-Assistenten: - Code-Überprüfung bei Unsicherheit - Klärende Fragen stellen **Verwendung:** Wird automatisch global eingebunden ### codebase-summary.sop.md Standard Operating Procedure für die Erstellung umfassender Codebase-Dokumentation: - Automatische Analyse von Architektur und Komponenten - Generierung von AGENTS.md, README.md, CONTRIBUTING.md - Update-Modus für inkrementelle Aktualisierungen - Mermaid-Diagramme für Visualisierungen **Verwendung:** Wird automatisch global eingebunden ### einfachbahn-naming.md Schreibweise des Teamnamens `#Einfachbahn` — immer mit Hashtag, großem E, keine Leerzeichen. **Verwendung:** Wird automatisch global eingebunden ### onboarding-dokumentation.md Strukturierter Plan für die Erstellung von Onboarding-/Migrationsdokumentation: - 7-Schritte-Prozess mit Fortschrittsverfolgung - Fokus auf fachliche End-to-End-Flüsse - Externe Schnittstellen und Datenmodelle - Mermaid-Diagramme für alle Visualisierungen **Verwendung:** `#onboarding-dokumentation` im Chat referenzieren ## Powers Powers liefern gebündeltes Plattformwissen, das Kiro bei passenden Fragen on-demand aktiviert. Quelle: [einfachbahn-lab/kiro_tools/power_skills_and_more](https://git.tech.rz.db.de/einfachbahn-lab/kiro_tools/power_skills_and_more) | Power | Zweck | |-------|-------| | `db-openshift-deploy` | Manuelles Deployment: Docker → Artifactory → OpenShift | | `db-pipeship-onboarding` | Repo mit pipeship aufsetzen (CI/CD, K8s, Trivy, Renovate) | | `db-dxp-platform` | DXP-Ökosystem-Nachschlagewerk (pipeship, CDaaS, Portal) | | `db-scm-info-compliance` | `scm-info.yaml` erstellen/validieren + Compliance-Checks | **Installation:** Power-Ordner über Kiro Powers-UI als „Local Directory" hinzufügen. Details: [`powers/README.md`](powers/README.md) ## Prompts ### unit-tests-motivation.md Umfassende Anleitung für die Erstellung qualitativ hochwertiger Unit Tests: - JUnit 5 + Mockito Guidelines - AAA-Pattern (Arrange-Act-Assert) - 80%+ Code Coverage Ziel - Constraints und Best Practices - Verifizierung und Troubleshooting **Verwendung:** `#unit-tests-motivation` im Chat referenzieren ## Skills Skills sind self-contained Pakete nach der [Agent Skills Specification](https://agentskills.io/specification): ein `SKILL.md` mit Workflow plus mitgelieferte Assets und Code. Im Gegensatz zu Steering-Dateien oder Prompts bringt ein Skill alles mit, was zur Ausführung gebraucht wird. ### pptx-infrago PowerPoint-Präsentationen (`.pptx`) im DB InfraGO Corporate Design mit Python: - Nutzt den offiziellen DB InfraGO Folienmaster (31 Layouts) — Logo, Footer, Foliennummer und Farben kommen automatisch vom Master - Eine Funktion pro Layout im Helper-Modul `db_infrago_pptx.py` - 10 mitgelieferte Hintergrundbilder mit thematischer Auswahl-Heuristik - Geführter 5-Schritte-Workflow: Infos sammeln → Bild wählen → Gliederung → Skript generieren → ausführen und öffnen **Verwendung:** Skill-Ordner nach `~/.kiro/skills/pptx-infrago/` (global) oder `/.kiro/skills/pptx-infrago/` (projektspezifisch) kopieren. Aktivierung durch Keywords wie „PowerPoint", „PPTX", „Foliensatz" oder explizit per `@pptx-infrago` im Chat. Voraussetzung: `pip install python-pptx` ## Verwendung ### In Kiro 1. **Globale Steering Files:** - Kopiere Dateien nach `~/.kiro/steering/` für projektübergreifende Nutzung - Oder nach `.kiro/steering/` für projektspezifische Nutzung 2. **Manuelle Steering Files:** - Referenziere mit `#dateiname` im Chat (z.B. `#onboarding-dokumentation`) 3. **Prompts:** - Kopiere in dein Projekt und referenziere mit `#dateiname` 4. **Skills:** - Kopiere den kompletten Skill-Ordner (z. B. `skills/pptx-infrago/`) nach `~/.kiro/skills//` für globale Verfügbarkeit - Oder nach `/.kiro/skills//` für projektspezifische Nutzung - Skills aktivieren sich automatisch über die Keywords im Frontmatter ihrer `SKILL.md`, lassen sich aber auch explizit über den Skill-Namen ansprechen ### Beispiele ``` # Onboarding-Dokumentation erstellen #onboarding-dokumentation Erstelle eine Onboarding-Dokumentation für dieses Projekt anhand des Plans. # Unit Tests schreiben #unit-tests-motivation Schreibe Unit Tests für die UserService Klasse nach diesem Leitfaden. # Codebase-Dokumentation generieren Erstelle eine AGENTS.md für dieses Projekt mit Fokus auf Architektur und Entwicklungspatterns. ``` ### Von Steering zu Spec: Projektspezifische Dokumentation Die Steering-Dateien in diesem Repository sind generische Vorlagen. Für konkrete Projekte empfiehlt es sich, daraus eine **projektspezifische Spec** zu erstellen: **Warum eine Spec erstellen?** - Specs ermöglichen strukturierte, schrittweise Umsetzung komplexer Aufgaben - Fortschrittsverfolgung und Iterationen mit Feedback - Anpassung der generischen Vorlage an projektspezifische Anforderungen - Dokumentation des Prozesses und der Entscheidungen **Workflow:** 1. **Steering-Datei als Basis nutzen:** ``` #onboarding-dokumentation Erstelle eine Spec für dieses Projekt basierend auf dieser Steering-Datei. Passe die Tasks an die spezifischen Anforderungen dieses Projekts an. ``` 2. **Kiro erstellt eine projektspezifische Spec:** - Analysiert das aktuelle Projekt - Passt die 7 Tasks an die Projektstruktur an - Erstellt eine `.kiro/specs/onboarding-dokumentation.md` Datei - Ermöglicht schrittweise Umsetzung mit Fortschrittsverfolgung 3. **Spec ausführen:** - Öffne die Spec-Datei in Kiro - Arbeite Task für Task durch - Kiro aktualisiert den Fortschritt automatisch - Iteriere bei Bedarf einzelne Tasks **Beispiel-Prompt:** ``` #onboarding-dokumentation Analysiere dieses Projekt und erstelle eine projektspezifische Spec für die Onboarding-Dokumentation. Berücksichtige dabei: - Die tatsächliche Projektstruktur und Technologien - Vorhandene Dokumentation, die erweitert werden soll - Spezifische Anforderungen unseres Teams Erstelle die Spec in .kiro/specs/onboarding-[projektname].md ``` ## Beitragen Neue Prompts, Steering-Dateien und Skills sind willkommen. Bitte beachte: **Steering Files & Prompts:** - Steering-Dateien sollten Front-matter mit `inclusion: manual` oder `inclusion: auto` enthalten - Nutze Mermaid für Diagramme (kein PlantUML oder ASCII-Art) - Füge Nutzungshinweise und Beispiele hinzu - Dokumentiere Constraints klar und eindeutig **Skills:** - Folge der [Agent Skills Specification](https://agentskills.io/specification): `SKILL.md` mit Frontmatter (`name`, `description`, ggf. `compatibility`/`metadata`) - Skill ist self-contained — alle Assets und Code-Module unter `assets/`, zusätzliche Referenzen unter `references/` - Eigene `README.md` im Skill-Ordner mit Struktur, Voraussetzungen und Mini-Beispiel - Keine Build-Artefakte (`__pycache__/`, `*.pyc`) committen — siehe `.gitignore` ## Lizenz Siehe [LICENSE](LICENSE) Datei für Details.