segment-profil
Erstellt aus quantitativen Umfragedaten (CSV) ein datenbasiertes Vergleichsprofil einer Teilgruppe (Segment/Persona) gegenüber dem Rest der Stichprobe: wer sie sind, wie sie sich unterscheiden, was si
Files1
View on GitHubSKILL.md.agents/skills/segment-profil/SKILL.md
GitHubSegment-Profil
Ziel: Die in der Anfrage des Nutzers beschriebene Teilgruppe datenbasiert
charakterisieren und gegen den Rest der Stichprobe kontrastieren — als Grundlage für
Personas/Zielgruppen. Ergebnis als Markdown in reports/.
Werkzeug
python3 scripts/survey.py <cmd> [...] [--file CSV]
Aus dem Projekt-Root ausführen. Fehlt scripts/survey.py, unter .claude/scripts/survey.py nachsehen oder survey.py im Projekt suchen.
profile— Spaltenüberblick (immer zuerst).freq COL [--filter "COL=WERT"]— Verteilung im Segment (Filter) vs. gesamt.freq COL --by SEGMENTSPALTE --sig— Segment als Spalte gegen ein Merkmal, mit Signifikanztest, um echte Unterschiede von Rauschen zu trennen.text COL [--filter ...] [--sample N]— O-Töne des Segments.
COL = Index (aus profile) oder eindeutiger Namensteil.
Umfrage-Kontext
Liegt neben der CSV ein Kontextdokument (<name>.context.md, bei genau einer CSV im Ordner
auch survey-context.md), vor der Segmentdefinition lesen. Die Spalten-Hinweise nennen
oft die geschäftlich relevanten Segmente und die Spalte, in der sie stecken — dort
nachsehen, bevor du einen eigenen Schnitt erfindest. Das Glossar hält das Profil in der
Sprache der Organisation. Die Zahlen kommen weiterhin nur aus dem Motor.
Der Abschnitt „Wer fehlt" zählt hier doppelt: Ein Segment-Profil beschreibt eine
Teilgruppe der Antwortenden, und wenn der Rekrutierungsweg schon eine Gruppe
ausgeschlossen hat, beschreibt das Profil unbemerkt eine gefilterte Grundgesamtheit. Das
gehört in die Methodik. Im Dokument genannte Erwartungen sind Prüfgegenstand, nie
Beleg — eine Persona darf nicht auf das zurechtgeschnitten werden, was jemand vermutet
hat. Gibt es kein solches Dokument, wie bisher vorgehen und am Ende einmal auf
umfrage-kontext hinweisen.
Vorgehen
- Segment definieren. Übersetze die Beschreibung in einen konkreten Filter (z. B. Nutzungshäufigkeit = „Täglich"). Bestimme die Segmentgröße (n und % der Stichprobe).
- Profilieren und die charakterisierenden Merkmale wählen (Demografie, Verhalten, Rollen, Aufgaben).
- Kontrastieren. Für jedes Merkmal: Verteilung im Segment vs. Gesamt/Rest.
Die interessanten Aussagen sind die Abweichungen („überdurchschnittlich oft …").
Wo möglich mit
--sigprüfen, ob der Unterschied belastbar ist. - Qualitativ anreichern. Freitext des Segments für typische Bedürfnisse/Zitate.
- Report speichern nach
reports/(date +%F+ kebab-Titel, nicht überschreiben) und Kurzcharakterisierung + Pfad in der Antwort nennen.
Report-Format
# Segment-Profil: <Segmentname>
**Datenbasis:** <Datei> · Segment n = <…> (<…% der Stichprobe>) · <Datum>
## Kurzcharakterisierung
2–3 Sätze: Wer ist dieses Segment, was macht es aus?
## Merkmale im Vergleich
| Merkmal | Segment | Gesamt/Rest | Auffälligkeit |
|---|---:|---:|---|
| … | …% | …% | ↑ überdurchschnittlich / ↓ / ≈ |
(Deutliche und ggf. signifikante Abweichungen zuerst.)
## Verhalten & Bedürfnisse
Was tut das Segment (Aufgaben/Nutzung) und was braucht es (Freitext-Themen, 1–2 Zitate)?
## Was das für die Praxis bedeutet
Implikationen für Produkt/Kommunikation/Priorisierung.
## Methodik
Segment-Definition (Filter), verglichene Spalten, genutzte Tests und — aus dem
Umfrage-Kontext — welche Grundgesamtheit die Stichprobe abdeckt und welche nicht.
Regeln
- Immer relativ berichten: Segment gegen Gesamt/Rest — absolute Zahlen des Segments allein sagen wenig. Abweichungen sind die Story.
- Segmentgröße nennen; bei n < ~30 zur Vorsicht raten.
- Signifikanz nutzen, um zufällige von echten Unterschieden zu trennen.
- Sprache = Sprache der Anfrage (Standard Deutsch). Report knapp halten.