bi-design

Plugin für VS Code (GitHub Copilot) und Claude Code, das Agenten das Corporate Design von Boehringer Ingelheim beibringt. Privat, weil es den BI-Master und Markenwerte enthält.

Verbindlich ist der BI-Master v2.1 (How-to slides): nur seine Designfarben und Custom Colors, keine Abstufungen, keine Standardfarben, Fußzeile mit Vertraulichkeitsvermerk. Referenzdecks liefern Storyline und Textmuster, nicht die Farben.

• Skill bi-designer – Marke für alles Visuelle: Farben (Tokens, Rollen, erlaubte Kontrastpaare), Schriften, Logo- und Symbolvarianten, 895 Icons, Rezepte für Power Apps, Power BI, PowerPoint/Word/Excel, Diagramme, Web, HTML-Mail, Teams-Karten. ppp nutzt ihn für Power-Apps-Theme, Prototypen und Power-BI-Theme.
• Agent und Skill bi-ppt – PowerPoint im BI-Master v2.1: aus Transkripten, Projektaufträgen, Notizen oder Excel ein neues Deck bauen, eine neue Version eines bestehenden Decks erzeugen (z. B. Projektteam-Update → Steering-Update), fremde Decks ins BI-Design umwandeln, Brand-Regeln prüfen und zur Sichtprüfung rendern.
• Skill bi-inhalt – arbeitet den Inhalt im Dialog aus (Ziel, Kernbotschaft, Storyline, Inhalt und Bildform je Folie) und übergibt ein abgenommenes Briefing an bi-ppt.
• Generator bippt (Python, python-pptx) – baut die Folien aus einer Spezifikation (JSON) mit Folientypen wie Status, Vergleich, Prozess, Timeline/Gantt, Maßnahmen, Kennzahlen, Diagramm, Tabelle – und kopiert gestaltete Folien aus der offiziellen BI Slide Library (184 Folien) ins Deck und füllt sie ({"bib": n, …}, bippt katalog). Änderungen später = Spec ändern und neu bauen; bestehende Folien ändert aendern (Bild tauschen, Absätze, Läufe, Formen verschieben). Zu jedem Deck schreibt bippt bauen die Folienbeschreibung <Name>.md mit Baustand je Folie.

Voraussetzungen

• VS Code mit GitHub Copilot und Agent Plugins, oder Claude Code; Zugriff auf dieses private Repo (Git-Anmeldung des Rechners).
• Python 3.9 oder neuer, aufgerufen wie bei ppp (Windows python, Mac python3), aber ohne -I, weil -I die mit pip --user installierten Pakete ausblendet. Die Pakete installiert bippt einrichten mit pip --user, ohne venv.
• PowerPoint zum Rendern (Mac oder Windows); sonst nur Prüfen.
• Für Logos und Icons der Ordner BrandDesign (nicht im Repo; Schriftdateien sind lizenziert).

Kurzanleitung

1. Installieren

VS Code. Ohne JSON und ohne Installationsskript. Das Repo ist privat: In VS Code mit einem GitHub-Konto angemeldet sein, das Lesezugriff hat. Das Plugin liegt seit 2.13.0 im Wurzelverzeichnis des Repos, darum gehen beide Wege:

• Direkt: Befehl „Chat: Install Plugin from Source“ (oder Agents-Ansicht › Customizations › Install from Source), https://github.com/portolasas/bi-design eingeben, die Vertrauensabfrage bestätigen.
• Über den Marktplatz, der neue Versionen selbst holt: Einstellungen öffnen, nach chat.plugins.marketplaces suchen, „Element hinzufügen“ und portolasas/bi-design eingeben (für ppp portolasas/ppp-plugin), oder in der Agents-Ansicht: Customizations › Browse › Configure Marketplaces › Add Marketplace. Dann bi-design aus dem Marktplatz installieren (Customizations › Browse oder Erweiterungen-Ansicht unter Agent Plugins) und die Vertrauensabfrage bestätigen.

Danach „Developer: Reload Window“.

Erscheint das Plugin nicht, prüfen, ob Agent Plugins eingeschaltet sind (chat.plugins.enabled).

Claude Code. Einmal je Rechner:

/plugin install bi-design --marketplace portolasas/bi-design

Ältere Versionen von Claude Code: /plugin marketplace add portolasas/bi-design, dann /plugin install bi-design@bi-design. Danach eine neue Sitzung.

2. Einrichten (einmal je Rechner)

Im Agenten-Menü bi-ppt wählen (Claude Code: Skill /bi-design:bi-ppt) und schreiben: „Prüfe die Umgebung.“ Der Agent ruft bippt umgebung auf und fragt per Karte, bevor er

• fehlende Python-Pakete installiert (bippt einrichten),
• alte Kopien von BI-PPT 1.x oder PPP 0.17 aus ~/.copilot, ~/.claude und ~/.bi-ppt löscht (bippt aufraeumen --ja); sie verdecken Agent und Skills des Plugins,
• den Ordner BrandDesign einträgt (bippt konfig --setze asset_root=<Ordner>).

Erwartet: ERGEBNIS: OK. Auf dem Mac fragt PowerPoint beim ersten Rendern nach Dateizugriff: „Auswählen…“ › Ordner Dokumente/BI-PPT-Render › „Zugriff erteilen“.

3. Eine Präsentation bauen

Mit dem Agenten bi-ppt, zum Beispiel:

• „Baue aus Transkript.vtt und Projektauftrag.docx ein Steering-Committee-Update für den 12.11.“
• „Mach aus Team-Update_KW44.pptx die Fassung für das Steering Committee.“
• „Bring Lieferantenpraesentation.pptx ins BI-Design.“
• „Prüfe Entwurf.pptx gegen die Brand-Regeln.“

Der Agent liest die Quellen, stellt eine gebündelte Rückfragerunde (Publikum, Datum, Ampeln, Widersprüche), schreibt <Name>.spec.json neben die Ausgabe, baut, prüft und rendert. Neben der PPTX liegen danach die Spec und die Folienbeschreibung <Name>.md: je Folie Typ, Gestaltung, Kernaussage, Inhalt und Notizen, damit andere Agenten und Sitzungen das Deck lesen können, ohne die PPTX auszulesen. Eine vorhandene Vorlage (z. B. von ppp) wird über dokument in der Spec zur Folienbeschreibung; ihr Text bleibt, bippt hängt seinen Abschnitt an.

Liegt der Arbeitsordner in einem Git-Repo (z. B. ein ppp-Projekt), committet der Agent wie ppp nach jedem abgeschlossenen Schritt ohne Rückfrage und pusht nach main: PPTX, Spec, Folienbeschreibung und neue Bilder.

Spätere Änderungen („Ändere auf Folie 4 den Termin“) liest der Agent aus der Folienbeschreibung und ändert nur die betroffenen Folien; bippt bauen meldet in ÄNDERUNGEN, welche Folien sich geändert haben. Wurde das Deck nach dem Bau in PowerPoint bearbeitet, bricht bippt bauen ab, statt die Handänderungen zu überschreiben; der Agent übernimmt das Deck dann als Basis und ändert nur die betroffenen Folien.

Für andere Medien (Word, Excel, Diagramme, Power BI, Web, Mail) genügt im normalen Chat „im BI-Design“; dann lädt der Agent den Skill bi-designer.

4. Aktualisieren

VS Code holt neue Versionen selbst (bei extensions.autoUpdate etwa alle 24 Stunden), danach „Developer: Reload Window“. Claude Code:

/plugin marketplace update bi-design
/plugin uninstall bi-design@bi-design
/plugin install bi-design@bi-design

Was sich geändert hat: CHANGELOG.md.

Aufbau

Einstellungen je Rechner: ~/.bi-design/config.json (asset_root, vorlage, vertraulichkeit, marke, render_dir).

Entwickeln

• Tests: python3 -I tests/test_plugin.py und python3 tests/test_bippt.py (Python mit den Paketen aus tools/requirements.txt).
• Jede Änderung, die nach main geht, erhöht die Version in beiden Manifesten und bekommt einen Eintrag in CHANGELOG.md; nur so holen VS Code und Claude Code die neue Fassung. test_plugin.py prüft den Gleichstand.
• Neuer Folientyp: tools/bippt/folien.py (@folientyp), Doku in skills/bi-ppt/reference/folientypen.md, Beispiel in skills/bi-ppt/beispiele/beispiel.spec.json.
• Folienbeschreibung und Baustand: tools/bippt/beschreiben.py. Neuer Folientyp: auch Inhalt (INHALT) und Gestaltung (_art) dort ergänzen.
• Textmaße: text_breite und umbrechen in tools/bippt/bausteine.py (Zeichenbreiten von Boehringer Forward, Umbruch wie PowerPoint); text(…, breite=w) meldet zu breite Wörter, vorlage.titel_pruefen zu lange Titel.
• Formen einer Folie immer über formen.alle() durchgehen (tools/bippt/formen.py): Fremde Decks enthalten Formen, bei denen python-pptx abbricht. Änderungen an bestehenden Folien gehören nach tools/bippt/aendern.py.
• Neue Marke: Profil in skills/bi-designer/marken/<profil>/ und eigene Vorlage (bippt vorlage <deck> -o …).
• Das Plugin ist das ganze Repo: Was eingecheckt ist, landet auf jedem Rechner, der bi-design installiert.
• Keine Projekt- oder Personendaten und keine Schriftdateien ins Repo. Referenz-Präsentationen und Chats zum Anlernen liegen lokal außerhalb von Git.