ankn
a5f8fb49ab
Bahn: aisupport, Analyse-O2C-C2S, awesome-bahn-mcp-servers, beam-mcp,
Confluence_Bot, db-planet-mcp-server, O2C-Harness, project-audit,
Projekt-KIQ-HP, teamlandkarte-mcp
Dhive: Jury-Voting
Privat: CV, NoteGraph (NOTE: NoteGraph needs complete redo after consolidation)
Shared: AI-Orchestrator, OrgMyLife, power_skills_and_more
Shared/references: symphony (read-only)
Bahn repos remain available as independent remotes - this monorepo
pulls them in via subtree, the originals are untouched.
229 lines
8.9 KiB
Markdown
229 lines
8.9 KiB
Markdown
# 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
|
|
`<projekt>/.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/<skill-name>/` für globale Verfügbarkeit
|
|
- Oder nach `<projekt>/.kiro/skills/<skill-name>/` 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.
|