Dokumentation › Administration › Zuständigkeiten in Forge
Zuständigkeiten eines Forge-Projekts anlegen – wer verantwortlich ist und wofür (Pfade, Vorgangstypen, Labels) –, Teams als Verantwortliche, Verschachtelung, Vorgängen zuordnen, automatisch zuweisen, CODEOWNERS erzeugen und Reviewer für Pull Requests vorschlagen lassen.
Zuletzt geändert am 13.11.2026
Auf dieser Seite
Zielgruppe & Rolle
Rolle: Projektverantwortliche (Projektrolle Maintainer oder Admin) zum Einrichten, alle Projektmitglieder zum Nutzen | Voraussetzung: ein Forge-Projekt; für Reviewer-Vorschläge und CODEOWNERS die GitHub-Anbindung
Eine Zuständigkeit beschreibt einen Teil eines Forge-Projekts – etwa „Personal“, „Service Desk“ oder „Alle Fehler“ – und nennt, wer dafür hauptverantwortlich ist und wer vertritt. Wofür sie gilt, legen Sie fest über Pfade im Repository (wie in einer CODEOWNERS-Datei von GitHub), über Vorgangstypen und über Labels. Verantwortlich kann eine Person oder ein Team sein.
Zuständigkeit anlegen
- Öffnen Sie das Projekt und wählen Sie Einstellungen › Zuständigkeiten.
- Klicken Sie auf Zuständigkeit anlegen und vergeben Sie Name und Schlüssel. Der Schlüssel bleibt danach fest; die Zuständigkeit
erhält automatisch das Label
owner::<Schlüssel>. - Legen Sie fest, wofür sie gilt: Pfade (ein Muster je Zeile), Vorgangstypen und/oder Labels. Es genügt eine der drei Angaben.
- Wählen Sie die verantwortliche Person oder ein Team und optional Vertretungen. Personen müssen Mitglieder des Projekts mit mindestens der Rolle Entwicklung sein. Vertretungen sind immer Personen.
| Muster | Bedeutung |
|---|---|
hr/** |
alles unterhalb von hr |
common/pkg/hrclient/ |
das Verzeichnis common/pkg/hrclient (ab dem Hauptverzeichnis) und alles darin |
logs/ |
jedes Verzeichnis namens logs, egal wie tief, und alles darin |
/docs/ |
nur das Verzeichnis docs im Hauptverzeichnis |
*.go |
jede Go-Datei im ganzen Repository |
docs/* |
nur die Dateien direkt in docs, nicht in Unterverzeichnissen |
Reihenfolge
Passen mehrere Zuständigkeiten, gilt die untere in der Liste – bei Dateien genau wie in CODEOWNERS die letzte passende Zeile.
Ziehen Sie allgemeine Zuständigkeiten (z. B. *.go) nach oben und spezielle nach unten.
Solange eine Person eine Zuständigkeit verantwortet oder vertritt, kann sie nicht aus dem Projekt entfernt oder auf die Rolle Melder gesetzt werden. Tragen Sie vorher eine andere Person ein.
Teams
Unter Einstellungen › Teams fassen Sie Projektmitglieder (ab der Rolle Entwicklung) zu einem Team zusammen. Die erste Person ist die Leitung. Ist ein Team verantwortlich, gilt seine Leitung als Hauptverantwortliche (bei automatischer Zuweisung) und alle Mitglieder werden als Reviewer vorgeschlagen. Ein Team, das eine Zuständigkeit verantwortet, kann nicht gelöscht werden, und seine Mitglieder können nicht aus dem Projekt entfernt werden, solange sie im Team sind.
Verschachteln
Eine Zuständigkeit kann unter einer anderen stehen (bis zu vier Ebenen). Hat sie keine eigene verantwortliche Person oder kein eigenes Team, übernimmt sie die der übergeordneten Zuständigkeit – samt deren Vertretungen. Eine übergeordnete Zuständigkeit lässt sich erst löschen, wenn keine untergeordnete mehr darunter steht.
Vorgängen zuordnen
In der Seitenleiste eines Vorgangs wählen Sie unter Zuständigkeit die passende; darunter stehen die Verantwortlichen. Weil sie ein
Label ist (owner::<Schlüssel>), können Sie Listen und Ansichten danach filtern und Boards danach gruppieren. Ein Vorgang hat höchstens
eine ausdrückliche Zuständigkeit, und diese hat Vorrang. Ohne sie gilt die Zuständigkeit, deren Vorgangstyp oder Label auf den
Vorgang passt; bei mehreren gewinnt die weiter unten stehende.
Automatisch zuweisen
Unter Projekteinstellungen › Automationen steht bei den Fertigen Automationen die Vorlage Zuständige automatisch
zuweisen: Sobald ein Vorgang ein owner::-Label trägt – beim Anlegen oder wenn das Label später gesetzt wird –, erhält er die
hauptverantwortliche Person seiner Zuständigkeit (bei einem Team dessen Leitung). Ein anderes Label weist nicht erneut zu; ohne
Zuständigkeit passiert nichts.
Die Automation besteht aus dem Schritt Zuständige Person hinzufügen mit dem Wert ownership_owner und einem Filter auf das
Label (any(trigger.data.addedLabels ?? [], hasPrefix(#, 'owner::'))). Sollen auch Vorgänge zugewiesen werden, deren Zuständigkeit
sich nur aus Vorgangstyp oder Label ergibt, bauen Sie eine eigene Automation mit dem Ereignis Element angelegt und
demselben Schritt – siehe
Automationen in Entwicklungsprojekten.
CODEOWNERS erzeugen
Einstellungen › Zuständigkeiten › CODEOWNERS anzeigen erzeugt die Datei .github/CODEOWNERS aus Ihren Zuständigkeiten. Übernehmen Sie
sie in das Repository – GitHub fordert dann bei jedem Pull Request automatisch Reviews der Verantwortlichen an. ConnectCLOUD schreibt die
Datei nicht selbst. Personen ohne mit ConnectCLOUD verknüpftes GitHub-Konto stehen nicht in der Datei; sie werden über der Datei genannt.
Nur Pfade landen in CODEOWNERS
CODEOWNERS kennt ausschließlich Pfadmuster. Zuständigkeiten, die nur über Vorgangstypen oder Labels passen, erscheinen daher nicht in der Datei; sie wirken in ConnectCLOUD (Zuordnung, automatische Zuweisung), nicht auf GitHub.
Reviewer für Pull Requests vorschlagen
Im Bereich Code eines Vorgangs zeigt ConnectCLOUD zu jedem offenen Pull Request die vorgeschlagenen Reviewer: die Verantwortlichen der Zuständigkeiten, deren Dateien der Pull Request ändert (bei einem Team alle Mitglieder). Mit Reviewer anfordern fordern Sie die Hauptverantwortlichen an – unter Ihrem eigenen GitHub-Konto. Vertretungen haken Sie bei Bedarf dazu an. Personen ohne verknüpftes GitHub-Konto oder ohne Zugriff auf das Repository werden angezeigt, aber nicht angefordert; die Autorin oder der Autor des Pull Requests erscheint nie. Hier zählen nur Pfade: Der Pull Request wird den Zuständigkeiten über seine geänderten Dateien zugeordnet.
Planungsagent
Der Planungsagent kennt die Zuständigkeit eines Vorgangs, ihre Verantwortlichen und Pfade und kann für Vorgänge
ohne Zuständigkeit ein passendes owner::-Label vorschlagen.
Hat das geholfen?
https://app.mbcom.cloud/knowledge/docs/base/forge-zustaendigkeiten