Project Hub - Skills im Detail

English Version

← Zurück zur Übersicht

Alle Skills werden als /project-hub:<skill-name> aufgerufen. Im Plugin liegen 21 Skills für den normalen Gebrauch. Dazu kommen drei Test-Skills, die nur für automatisierte Tests gedacht sind (siehe unten).

Die meisten Skills arbeiten mit dem aktiven Projekt. Ist keines geladen, weisen sie auf /project-hub:resume hin.

Übersicht

Einstieg und Navigation

setup

Richtet das Plugin ein. Der Ablauf steht unter Installation.

configure

Zeigt die Werte aus config.yaml, fragt nach der gewünschten Änderung und schreibt die Datei. Siehe Konfiguration. Über "Projekttypen verwalten" listest und löschst Du eigene Projekttypen oder startest type-creator.

help

Zeigt eine Skill-Übersicht, das aktive Projekt und die verfügbaren Projekttypen, eigene Typen mit Kennzeichnung "custom".

session-start

Geführter Einstieg in eine Arbeitssitzung:

1. Prüft venv, config.yaml und die Python-Pakete. Bei Lücken stoppt der Skill und verweist auf setup.
2. Mit Projektname als Argument lädt er dieses Projekt. Ohne Argument zeigt er die Liste der aktiven Projekte, bei einem unbekannten Namen die Liste aller Projekte, jeweils mit der Option "Neues Projekt anlegen".
3. Lädt Kontakte, die letzten fünf Notizen und, außer bei Typ generic, die Wissensdokumente.
4. Setzt das Projekt als aktiv und zeigt einen Kopf mit Hinweisen, etwa fehlende Kontakte, offene Action Items, Go-Live in weniger als 14 Tagen oder keine Aktivität seit sieben Tagen.

resume

Lädt ein Projekt per Name oder Slug, sonst aus einer nummerierten Liste. Anschließend lädt er parallel:

• projektspezifische Kontakte, getrennt nach intern und extern
• geteilte Kontakte aus allen Projekten (vollständig, auch über mehrere Seiten)
• die Notizen des Projekts (50 pro Seite, bei mehr verweist er auf search)
• bei Typ ungleich generic alle Wissensdokumente des Typs, die danach als Kontext dienen

Danach setzt er das Projekt als aktiv und zeigt Typ, Status, Phase, Go-Live, Beschreibung, Kontakte, letzte Notizen und den Docs-Ordner.

dashboard

Listet alle Projekte, gruppiert nach Status (aktiv, pausiert, abgeschlossen, abgebrochen, sonstige) mit Typ, Phase, Go-Live und letzter Aktivität. Das aktive Projekt trägt die Markierung "aktiv". Verknüpfte Projekte erscheinen als Zeile "Relationen". Bei genau einem Projekt zeigt der Skill dessen Eckdaten direkt.

status

Zeigt Projektdaten, interne, externe und geteilte Kontakte, die letzten Notizen und die Dokumente. Anschließend kannst Du Phase, Go-Live, Status (aktiv, pausiert, abgeschlossen, abgebrochen), Beschreibung sowie Produkte und Markt ändern.

next-step

Wertet offene Action Items, Go-Live-Termin, letzte Notizen und Kontakthistorie aus:

• Action Items gelten als offen, solange der Inhalt kein Erledigt-Kennzeichen enthält (ein Wort wie "erledigt", "done" oder "fertig", oder eine vollständig abgehakte Checkliste). Das Alter bestimmt die Priorität: älter als 7 Tage hoch, 3 bis 7 Tage mittel, jünger niedrig.
• Ein Go-Live in höchstens 7 Tagen gilt als kritisch, bis 14 Tage als hoch, bis 30 Tage als mittel.
• Am Ende steht genau ein empfohlener nächster Schritt mit passendem Skill.

Projekte

new-project

Fragt zuerst, ob Du eine ausgefüllte Vorlage einfügen, einen Dateipfad angeben oder interaktiv anlegen willst. Interaktiv wählst Du den Typ aus der Liste der eingebauten und eigenen Typen und beantwortest die Felder einzeln. Je nach Typ kommen Markt, Produkte und Phase (merchant-onboarding), ein Kundenname (consulting, wird als externer Kontakt gespeichert) oder Eventdatum und Ort (event) dazu. Das neue Projekt wird aktiv gesetzt und sein Docs-Ordner angelegt. Existiert der Slug bereits, nennt der Skill das vorhandene Projekt.

get-template

Gibt die ausfüllbare Vorlage eines Projekttyps als Markdown-Block aus, damit Du sie außerhalb des Chats ausfüllst und mit new-project importierst. Für Typen ohne eigene Vorlage kommt die generische Vorlage mit einem Hinweis.

type-creator

Assistent für eigene Projekttypen: Name, Beschreibung, optional Phasen und typische Kontaktrollen, dann Vorschau und Anlage unter ~/.project-hub/project-types/<slug>/. Der Name wird zum Slug. Ein Typ mit dem Namen eines eingebauten Typs überschreibt diesen.

Kontakte und Notizen

add-contact

Fragt zuerst den Namen und sucht damit projektübergreifend nach Duplikaten, auch in geteilten Kontakten. Danach fragt er Typ (intern oder extern), Rolle, optional E-Mail, Telefon, Firma und Notizen. Interne Kontakte können als projektübergreifend geteilt gespeichert werden, externe nie. Der Server blockiert Duplikate geteilter Kontakte, Details unter MCP-Tools.

add-note

Speichert eine Notiz im aktiven Projekt. Notiztypen:

Ohne Argument leitet der Skill den Typ aus eingefügtem Inhalt ab, wenn er eindeutig ist (Mail-Header oder Teilnehmerliste mit Agenda-Bezug), und fragt sonst nach. Beruht der Inhalt auf lokalen Dateien oder einem Ordner, kopiert der Skill die Originale im selben Schritt als Anhänge. Danach kannst Du weitere Dateien anhängen. Mehr dazu unter Technische Details.

edit-note

Lädt eine Notiz per ID oder aus einer Liste und ändert Titel, Inhalt, Typ oder Agenda, hängt Dateien an oder entfernt Anhänge. Die Notiz muss zum aktiven Projekt gehören.

Eine Änderung aktualisiert nur die Datenbank. Die beim Anlegen geschriebene Markdown-Datei im Docs-Ordner bleibt auf dem alten Stand und liegt bei einem Typwechsel im alten Unterordner. Felder lassen sich überschreiben, aber nicht leeren.

meeting-prep

Bereitet eine Meeting-Agenda vor:

1. Fragt Titel und Datum, dann ob das Meeting wiederkehrend oder einmalig und intern oder extern ist.
2. Bei wiederkehrenden Meetings bietet er offene Punkte früherer Meeting-Notizen an.
3. Du wählst die Tiefe: "Nur die dringlichsten Punkte" oder "Vollständiger Überblick".
4. Pro Punkt erfasst er Titel, Kontext, Dringlichkeit und optional Quellen, und sucht dafür in den Notizen des Projekts. Bei externen Meetings fragt er je Quelle, ob sie für externe Teilnehmer geeignet ist.
5. Er rendert die Agenda und speichert sie auf Wunsch als Notiz vom Typ meeting-notes. Die Agenda steht dabei in Inhalt und Agenda-Feld, damit summarize sie später für den Abgleich nutzt.

search

Sucht in Notizen (Titel und Inhalt) und Kontakten (Name, Rolle, E-Mail, Firma). Bei aktivem Projekt fragt der Skill, ob nur dort oder in allen Projekten gesucht wird. Die Kontaktsuche enthält immer auch geteilte Kontakte.

Die Suche ignoriert Groß- und Kleinschreibung nur bei ASCII-Buchstaben. Umlaute und andere Nicht-ASCII-Zeichen werden exakt verglichen, "Ärger" findet also nicht "ärger". Die Zeichen % und _ im Suchbegriff wirken als Platzhalter, sie werden nicht maskiert.

Kommunikation

summarize

Fasst eine gespeicherte Notiz (per ID) oder eingefügten Text zusammen, als E-Mail-, Meeting- oder allgemeine Zusammenfassung. Bei Meeting-Notizen mit Agenda gibt es einen Agenda-Abgleich. Auf Wunsch speichert der Skill das Ergebnis als Notiz vom Typ note.

compose

Entwirft E-Mail, Slack- oder Teams-Nachrichten im Projektkontext. Bei merchant-onboarding-Projekten fragt er immer, ob die Nachricht an den externen Merchant oder intern geht, weil Ton und Stil sich unterscheiden. Mit den Argumenten export und import gibt der Skill Projekte weiter:

• Export: schreibt Projekt, Kontakte, Notizen und Verknüpfungen in eine JSON-Datei, standardmäßig nach ~/.project-hub/exports/{slug}-{datum}.json. Anhänge sind nicht enthalten.
• Import: liest eine solche Datei. Bei vorhandenem Slug wählst Du skip (Standard, bricht ab), rename oder overwrite.

overwrite löscht das vorhandene Projekt mit Kontakten und Notizen aus der Datenbank und entfernt zusätzlich den gesamten Docs-Ordner des Projekts von der Festplatte. Damit gehen auch die Markdown-Dateien der Notizen und alle Anhangsdateien verloren. Danach legt der Import das Projekt neu an, ohne Dateien.

Wissen, Berichte und Übergaben

knowledge

Verwaltet die Wissensdokumente des Projekttyps unter ~/.project-hub/knowledge/<typ>/:

sync zeigt immer zuerst, was neu oder geändert ist, und überschreibt Dateien erst nach Deiner Bestätigung.

report

Erzeugt einen eigenständigen HTML-Bericht und öffnet ihn im Browser:

Der Bericht listet alle Notizen vom Typ action-item unter "Offene Aufgaben", unabhängig davon, ob sie erledigt sind. Einen Erledigt-Filter wie bei next-step gibt es im Bericht nicht.

Der Bericht landet standardmäßig unter ~/.project-hub/reports/. Für ein PDF druckst Du ihn im Browser. Die Beschriftungen im Bericht sind deutsch.

vacation-handover

Erzeugt ein Übergabe-Dokument für alle offenen Projekte des aktiven Projekttyps:

1. Der Skill braucht das Wissensdokument vacation-handover des Projekttyps. Fehlt es, bricht er mit einer Anleitung ab. Mitgeliefert wird eine Vorlage nur für merchant-onboarding.
2. Start- und Enddatum kommen aus dem Argument oder werden abgefragt.
3. Er lädt alle Projekte des Typs außer abgeschlossenen und abgebrochenen und je Projekt Kontakte und Notizen.
4. Er füllt die Vorlage aus Projektdaten, Notizen und Kontakten (ToDos, Meetings, Deliverables, Risiken, Teams-Link, JIRA-Ticket und Kontakte nach Rolle).
5. Auf Zuruf exportiert er einen Confluence-Block oder speichert das Dokument als Notiz im aktiven Projekt.

Der Autorenname im Dokument ist im Skill fest hinterlegt und kommt nicht aus der Konfiguration.

Test-Skills

create-testdata, reset-testdata und delete-testdata sind Infrastruktur für automatisierte Skill-Tests. Sie sind für maschinellen Aufruf gedacht, werden nie aus normaler Konversation ausgelöst und arbeiten nur mit Datensätzen, deren Name mit zz-sandbox- beginnt.

Verknüpfungen von Projekten

Für Projekt-Verknüpfungen gibt es keinen eigenen Skill. Du bittest Claude, die Tools tool_link_project und tool_unlink_project aufzurufen. Dashboard und Bericht zeigen die Verknüpfungen an. Siehe MCP-Tools.