Personas erstellen

Schritt-für-Schritt-Anleitung zum Erstellen von KI-Personas in CodeCourier, inklusive aller zehn Persona-Typen, Felder, Kontextbindung und Initialkonfiguration.

7 min Lesezeit

personascreateconfiguration

Das Erstellen einer Persona in CodeCourier dauert nur wenige Klicks im Dashboard. Einmal erstellt, kann die Persona in jeder Workflow-Pipeline innerhalb des Projekts verwendet werden. Diese Anleitung führt durch den Erstellungsprozess, erklärt jedes Feld und gibt Empfehlungen, um aus Ihren Persona-Konfigurationen die besten Ergebnisse zu holen.

Eine Persona über die UI erstellen

Zur Personas-Seite navigieren

Suchen Sie im Projekt-Dashboard den Eintrag Personas in der Seitennavigation. Falls Sie ihn nicht sehen, müssen Sie ggf. scrollen oder ihn über das Navigationsmenü öffnen. Die Personas-Seite liegt unter /p/{projectId}/personas.

Den Erstellen-Dialog öffnen

Klicken Sie auf die Schaltfläche + Create oben rechts im Seitenheader. Dies öffnet einen Dialog, in dem Sie die grundlegenden Persona-Daten eingeben. Wenn noch keine Personas existieren, zeigt die Seite einen Leerzustand mit prominenter Erstellen-Schaltfläche.

Einen Namen eingeben

Geben Sie Ihrer Persona einen sprechenden Namen, der ihren Zweck widerspiegelt. Gute Namen vermitteln Rolle und Spezialisierung auf einen Blick:

Frontend Designer - ein Designer mit Fokus auf UI-Implementierung
Strict Code Reviewer - ein Reviewer mit detailliertem Feedback
Security Checker - ein Checker, der Sicherheitsstandards durchsetzt
Performance Optimizer - ein Optimizer mit Fokus auf Laufzeiteffizienz
Architecture Planner - ein Planner für Systemdesign-Aufgaben

Namen dürfen nicht leer sein und werden beim Absenden validiert. Sie können später auf der Persona-Detailseite geändert werden.

Einen Typ wählen

Wählen Sie den Persona-Typ aus dem Dropdown. CodeCourier definiert die folgenden Typen, jeder entspricht einer bestimmten Rolle in der Workflow-Pipeline:

Designer - Primärer Coding- und Implementierungs-Agent
Checker - Code-Review mit Pass/Fail-Verdikt und Feedback
Optimizer - Code-Verbesserung und Refactoring-Agent
Prompter - Prompt-Engineering- und Spezifikations-Agent
Investigator - Codebasis-Analyse- und Recherche-Agent
Planner - Architektur- und Issue-Analyse-Agent
Deep-Dive - Intensiver Multi-System-Analyse-Agent
Reviewer - Qualitatives Code-Review ohne Pass/Fail-Verdikt
Custom - Freier Typ für spezialisierte oder nicht-standardisierte Rollen

Der Typ bestimmt das Icon der Persona und ihr Standardverhalten in Workflow-Pipelines. Die Standardauswahl ist designer.

Eine Beschreibung hinzufügen (optional)

Das Beschreibungsfeld ist optional, aber empfohlen. Nutzen Sie es, um den Zweck, die Spezialisierung oder zu beachtende Konventionen der Persona zu dokumentieren. Das hilft Teammitgliedern zu verstehen, wofür die Persona gedacht ist, wenn sie in Workflow-Konfigurationen ausgewählt wird.

Formular absenden

Klicken Sie auf Create, um die Persona zu speichern. Bei Erfolg werden Sie automatisch zur Persona-Detailseite weitergeleitet, wo Sie erweiterte Einstellungen wie Modellauswahl, Anweisungen, Skills, Commands, Scripts und Kontextbindung konfigurieren können.

Schneller Einstieg

Nach dem Erstellen einer Persona sind die beiden wichtigsten nächsten Schritte das Schreiben ihrer Anweisungen und die Auswahl ihrer Skills. Der Instructions-Tab definiert das Verhalten, die Coding-Standards und domänenspezifischen Regeln. Der Skills-Tab spielt relevante Domänenwissens-Pakete, Commands und Scripts ein.

Persona-Felder-Referenz

Der Erstellen-Dialog erfasst die wesentlichen Felder. Die vollständige Konfiguration ist auf der Persona-Detailseite nach der Erstellung verfügbar. Hier ist eine vollständige Referenz aller Felder:

Kernfelder (bei Erstellung gesetzt)

Feld	Typ	Pflicht	Beschreibung
`name`	string	Ja	Anzeigename der Persona. Darf nicht leer sein.
`type`	enum	Ja	Rollentyp: designer, checker, optimizer, prompter, investigator, planner, deep-dive, reviewer oder custom.
`description`	string	Nein	Menschlich lesbare Beschreibung des Zwecks der Persona.

Konfigurationsfelder (auf der Detailseite gesetzt)

Feld	Typ	Standard	Beschreibung
`cliId`	string	Projekt-Standard	Welches CLI-Tool verwendet werden soll (z. B. claude, opencode, codex).
`model`	string	Tool-Standard	Spezifisches LLM-Modell (z. B. claude-opus-4-6, claude-sonnet-4-6).
`thinkingEffort`	string	none	Reasoning-Tiefe: none, low, medium, high, xhigh oder max.
`instructions`	string	Leer	Benutzerdefinierte System-Anweisungen für den Agenten.
`contextId`	ID	Keiner	Bindet ein Kontext-Dokument an diese Persona. Das aktive Versions-Markdown des Kontexts wird zusammen mit den Anweisungen der Persona in die Sandbox eingespielt.
`selectedSkills`	string[]	Leer	Array von Skill-IDs, die während Sitzungen verfügbar sind.
`selectedCommands`	string[]	Leer	Array von Command-IDs, die in die Sandbox als Shell-Aliase oder -Commands eingespielt werden.
`selectedScripts`	string[]	Leer	Array von Script-IDs, die als ausführbare Scripts in die Sandbox eingespielt werden.
`learningsEnabled`	boolean	true	Ob kompilierte Learnings in Sitzungen eingespielt werden.
`isEnabled`	boolean	true	Ob die Persona aktiv und in Pipelines auswählbar ist.

Versionierungs-Felder (automatisch verwaltet)

Feld	Typ	Beschreibung
`version`	number	Monoton steigende Versionsnummer. Beginnt bei 1 bei der Erstellung.
`isLatest`	boolean	True auf der aktuellen aktiven Version. Nur eine Version pro Persona ist gleichzeitig latest.
`parentPersonaId`	ID	Zeigt auf den Vorgänger-Versionsdatensatz. Null bei der ersten Version.

Versionierung und Bearbeitung

Das Bearbeiten der Anweisungen oder Konfiguration einer Persona auf der Detailseite erzeugt automatisch eine neue Version. Die neue Version wird isLatest und alle zukünftigen Workflow-Ausführungen verwenden sie. Vorherige Versionen bleiben erhalten und sind im Versionsverlauf sichtbar.

Kontextbindung

Kontext-Dokumente sind wiederverwendbare Markdown-Ressourcen - Dokumentationen, Referenzleitfäden, Architekturnotizen oder andere Referenzmaterialien -, die Sie getrennt von Persona-Anweisungen pflegen. Wenn Sie ein Kontext-Dokument per contextId-Feld an eine Persona binden, wird das aktive Versions-Markdown des Kontexts automatisch vor die eigentlichen Anweisungen der Persona in die Sandbox-Konfiguration gesetzt.

Das ist besonders mächtig, um Kontext über mehrere Personas zu teilen, ohne Inhalte zu duplizieren. Beispiel: Ein “Codebasis-Architektur”-Kontext-Dokument könnte gleichzeitig an Ihre Designer-, Reviewer- und Deep-Dive-Personas gebunden werden. Aktualisieren Sie das Architektur-Dokument, übernehmen alle drei Personas die Änderung beim nächsten Run.

Zum Binden eines Kontexts navigieren Sie zum Tab Context auf der Persona-Detailseite und wählen ein Kontext-Dokument aus dem Dropdown. Nur aktive Kontext-Dokumente werden gelistet.

Personas über die API erstellen

Personas können auch programmatisch über die Convex-Mutation erstellt werden. Das ist nützlich, um Persona-Setup zu automatisieren oder eigene Tools zu bauen:

create-persona.ts

import { api } from "@/convex/_generated/api";
import { useMutation } from "convex/react";

// In a React component:
const createPersona = useMutation(api.personas.create);

const personaId = await createPersona({
  projectId: "your-project-id",
  name: "Frontend Designer",
  type: "designer",
  description: "Specialized in React and Tailwind CSS",
  model: "claude-opus-4-6",
  instructions: "Follow the project's component patterns...",
  contextId: "context-id-for-architecture-doc",
  selectedSkills: ["frontend-design", "vitest-testing"],
  selectedCommands: ["lint-check", "type-check"],
  selectedScripts: ["run-tests"],
  isEnabled: true,
});

Validierung

Der Persona-Name wird serverseitig validiert. Leere Namen oder Namen über der Maximallänge führen dazu, dass die Mutation einen ConvexError wirft. Trimmen Sie Benutzereingaben stets vor dem Absenden.

Bestehende Personas duplizieren

Wenn Sie eine Persona ähnlich einer bestehenden erstellen wollen, nutzen Sie die Aktion Duplicatein der Persona-Liste. Dies erstellt eine Kopie mit “(copy)” im Namen und identischen Einstellungen - inklusive derselben Kontextbindung, Skills, Commands und Scripts. Sie können die Kopie dann umbenennen und nur die Felder anpassen, die sich ändern müssen. Duplizieren ist oft schneller als von Null zu starten, wenn Sie mehrere Personas mit ähnlichen Konfigurationen benötigen.

Massenoperationen

Die Personas-Listenseite unterstützt Mehrfachauswahl per Checkbox. Wählen Sie mehrere Personas aus und nutzen Sie die Massenaktionsleiste, um sie alle gleichzeitig zu löschen. Das Massenlöschen verwendet Soft-Delete, d. h. die Personas wandern in den Papierkorb und können bei Bedarf wiederhergestellt werden.

Nächste Schritte

Persona-Konfiguration

Tiefer Einblick in Modellauswahl, Anweisungen, Skills, Commands, Scripts, Kontext und Versionierung.

Eingebaute Personas

Lernen Sie alle zehn Persona-Typen kennen, die in jedem Projekt verfügbar sind.