CommunityRecherche & Datenanalysegithub.com

bbulman/affinity-diagram

Sortiert echte Forschungsnotizen in die Themen, die die Leute tatsächlich teilen. Benötigt vorhandene Daten, um zu funktionieren.

Was ist affinity-diagram?

Diese Fähigkeit für KI-Agenten strukturiert unstrukturierte Forschungsbeobachtungen (z. B. Interviewzitate, Feldnotizen) zu einem aussagekräftigen Affinitätsdiagramm. Sie folgt einer strengen Bottom-up-Sortierung, bei der Notizen wiederholt (auch blind durch einen zweiten Agenten) gruppiert werden, um die Zuverlässigkeit der Cluster zu prüfen. Die Fähigkeit erzwingt eine benutzerzentrierte Namensgebung (Aussagesätze statt Schlagworte), zählt Personen statt Notizen und schließt Ausreißer konsistent aus. Ausgabe ist eine strukturierte `affinity.md` in einem gemeinsamen Forschungsordner. Sie unterstützt die gängigen KI-Agenten-Plattformen (Claude Code, Cursor, Codex u. a.) und erfordert entweder eine bereitgestellte `primary.md`-Datei oder Daten aus einem Posteingang. Falls zu wenig Daten vorhanden sind, stoppt der Agent und verweist auf ein Interviewskript-Skill. Die Fähigkeit zielt darauf ab, Forschern und Produktteams valide, datengestützte Themengruppierungen zu liefern, die direkt für Entscheidungen oder die Erstellung von Personas genutzt werden können.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bbulman/research-skills/tree/HEAD/skills/affinity-diagram

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Verwandelt einen Haufen Beobachtungen in eine Struktur, über die man nachdenken kann. Es gibt keinen Proto-Modus: Ohne Daten gibt es nichts zu sortieren.

Lies ~/.claude/skills/research-shared/contract.md und halte dich während des gesamten Vorgangs daran. $SHARED bedeutet diesen Ordner. Deine Ausgabe ist affinity.md im Ideenordner.

Schritte

  1. Start. Bevor du irgendetwas anderes tust, suche nach Daten in inbox/, --evidence und primary.md. Wenn keine vorhanden sind, sag, was dieses Skill braucht, und stoppe, ohne etwas zu erstellen. Folge dann „Start a run“ im Vertrag. Der Intake nimmt jedes neue Material auf. Erledigt, wenn das Briefing eine Entscheidung nennt und der Intake Bericht erstattet hat.

  2. Notizen auslegen. Verwende jeden Auszug aus primary.md sowie alles andere, worauf die Person dich hinweist: exportierte Haftnotizen, eine Tabelle mit Feedback, Feldnotizen. Teile jeden Auszug in Notizen auf, die jeweils eine einzelne Beobachtung enthalten. Erledigt, wenn du mindestens 20 Notizen von mindestens 3 Personen hast. Bei weniger stoppe, sag, wie viele noch benötigt werden, und verweise auf /create-interview-script.

  3. Von unten nach oben sortieren. Lege die Forschungsfragen und alle erwarteten Kategorien beiseite. Nimm eine Notiz, finde heraus, wozu sie gehört, und beginne einen neuen Stapel, wenn nichts passt. Benenne noch nichts. Jede Notiz lebt in einem Stapel. Erledigt, wenn jede Notiz in einem Stapel ist.

  4. Noch einmal sortieren, blind. Starte einen frischen Agenten nur mit den Notizen und lass ihn sortieren, ohne deine Stapel zu sehen. Vergleiche die beiden. Notizen, die unterschiedlich gelandet sind, zeigen, wo die Struktur schwach ist: lies jede erneut und entscheide, wohin sie gehört. Wenn du keinen Agenten starten kannst, sag dies in den Laufnotizen. Erledigt, wenn jede Uneinigkeit gelöst oder aufgelistet ist und die Laufnotizen sagen, wie viele Notizen sich bewegt haben.

  5. Jeden Cluster als Satz benennen. Sag, was diese Personen gemeinsam haben, in ihrer Sprache: „Eigentümer erfahren erst von einem No-Show, wenn der Patient nicht erscheint“, statt „No-Shows“. Erledigt, wenn kein Clustername eine Themenbezeichnung ist.

  6. Personen zählen, nicht Notizen. Zähle für jeden Cluster die verschiedenen Personen und Organisationen. Eine gesprächige Person ist eine Stimme, egal wie viele Notizen sie liefert. Ein Cluster, der auf einer einzelnen Person beruht, wandert zu Ausreißern. Teile jeden Stapel mit mehr als 12 Notizen auf. Eine einzelne abweichende Notiz geht ebenfalls zu Ausreißern, mit der Begründung, warum sie abweicht. Erledigt, wenn jeder Cluster mindestens 2 Personen hat und Ausreißer erklärt, warum jeder einzelne dort ist.

  7. Zu Themen stapeln. Gruppiere die Cluster in 3 bis 6 Themen. Jedes Thema sagt, was es uns über die Entscheidung im Briefing verrät und wie viele Personen dahinterstehen. Erledigt, wenn jeder Cluster unter einem Thema sitzt.

  8. Nach Überraschungen suchen. Was widerspricht den Erwartungen des Teams? Welche Personengruppe fehlt an der Wand? Erledigt, wenn „Was uns überrascht hat“ mindestens eine Zeile oder ein [gap] enthält.

  9. Schreiben. Fülle $SHARED/templates/affinity.md aus. Erledigt, wenn jeder Abschnitt seine Behauptungen oder ein [gap] hat.

  10. Abschließen. Folge „Finish a run“ im Vertrag. Das nächste Skill ist /summarize-research oder im echten Modus /create-persona.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Verwandte Skills