bbulman/findability

Auffindbarkeit (Findability)

„Niemand findet es“ ist ein Symptom mit vier typischen Ursachen, die jeweils eine andere Behebung erfordern. Diese Skill unterstützt die Entscheidung, was zuerst geändert werden soll: Sie trennt die Ursache von der Beschwerde, wählt die günstigste Lösung, die die Ursache behebt, und legt eine Messgröße fest, die zeigt, ob es funktioniert hat.

Bevor Sie beginnen

Sie benötigen	Wenn es fehlt
Was die Leute nicht finden können, wer sie sind und wo sie gesucht haben	Fragen. Bleibt es vage, listen Sie die Kandidaten auf und behandeln Sie sie als Hypothesen.
Die Website, App oder zumindest deren Navigation	Fragen. Ohne diese können Sie nur den Diagnoseplan schreiben.
Ein Suchprotokoll als CSV: query,count,results und clicks, falls verfügbar	Sagen Sie, was exportiert werden soll und für welchen Zeitraum. Liefern Sie den Diagnoseplan, die Messgrößen und die leeren Tabellen. Schätzen Sie niemals, was das Protokoll gesagt hätte.
Analysen, Supportanfragen, ein Inventar	Sagen Sie, welche Schlussfolgerungen sie ändern würden, und markieren Sie diese als unbestätigt.

Methode

1. Formulieren Sie das Scheitern als Aufgabe. „Ein [wer], der [Ziel] erreichen will, sucht in [wo] nach [Sache] und [was passiert].“ Eine Zeile pro Beschwerde, in deren eigenen Worten.

2. Lesen Sie das Protokoll und nutzen Sie seine Zahlen.

   node "${CLAUDE_SKILL_DIR}/scripts/search-log.mjs" searches.csv
   

   Wenn das Protokoll zu klein für ein Ranking ist, verwenden Sie es als Liste der eingegebenen Wörter und geben Sie keine Raten an. Geben Sie an, welchen Zeitraum der Export abdeckt; das Skript kann das nicht wissen.

3. Diagnostizieren Sie vor dem Verschreiben. Gehen Sie die Ursachen in dieser Reihenfolge durch, da jede auf der vorherigen aufbaut. Mehrere können gleichzeitig zutreffen. Markieren Sie jede Schlussfolgerung als bestätigt oder erschlossen.

   Ursache	Wie bestätigen	Übliche Behebung	Skill
   Fehlend: existiert nicht	Unter jedem verwendeten Namen suchen. Null-Ergebnis-Anfragen ohne passenden Inhalt	Erstellen oder klar sagen, dass es nicht angeboten wird	content-inventory
   Falsch bezeichnet: existiert unter anderem Namen	Ihr Wort ergibt null Ergebnisse oder keine Klicks, während der Inhalt unter Ihrem Namen liegt; Pogo-Sticking	Umbenennen, Synonyme hinzufügen	labeling
   Vergraben: gut benannt, kein Weg dorthin	Schritte von Startseite und Hubs zählen; nach Waisen, Sackgassen, tiefer Paginierung als einzigem Weg, auf der Bereichsseite gestarteten Suchen suchen, die es hätten anbieten sollen	Dort verlinken, wo Leute bereits suchen, oder verschieben	navigation, sitemaps
   Suche funktioniert nicht: existiert, Anfrage passt, Ergebnisse sind falsch	Top-Anfragen selbst ausführen und Ergebnisse lesen; Ergebnisse ohne Klicks, Umformulierungen, Ausstiege von der Ergebnisseite	Best Bets, Synonyme, Indexbereich, Ranking	Schritt 5

   Viele Auffindbarkeitsprobleme sind günstiger in Beschriftungen und Gruppierungen zu beheben als in der Suchmaschine. Beginnen Sie daher nicht mit der Suche. Tiefe allein ist kein Fehler: Die Drei-Klick-Regel ist ein Mythos, und Leute klicken weiter, wenn jeder Schritt klar nach ihrem Ziel riecht.

4. Entscheiden Sie, welcher Weg funktionieren sollte. Unterstützen Sie sowohl das Stöbern als auch die Suche, da die Leute zwischen ihnen wechseln. Top-Anfragen sollten in ein oder zwei Schritten von der Startseite erreichbar sein.

   Die Person	Zu stärkender Weg
   Kennt den genauen Namen	Suche oder eine A-bis-Z-Liste
   Kennt das Bedürfnis, aber nicht den Namen	Stöbern mit klaren Beschriftungen, dann Facetten
   Erkundet oder vergleicht	Stöbern, Filter, verwandte Links
   Kommt zu etwas zurück	Aktuelle Elemente, gespeicherte Ansichten, Verknüpfungen
   Ist mitten in einer Aufgabe	Ein kontextueller Link oder Hinweis an der Stelle, an der sie arbeiten

5. Beheben Sie die Suche, wenn die Suche die Ursache ist. Platzieren Sie kuratierte Best Bets oben in den Ergebnissen für die Top-Anfragen. Erstellen Sie Synonymsets aus den Variantengruppen des Skripts, beginnend mit denen, die als SYNONYM WOULD ANSWER markiert sind, und fügen Sie dann hinzu, was nur ein Mensch erkennt, wie Akronyme und Fachjargon. Lassen Sie niemals zu, dass eine No-Results-Seite eine Sackgasse ist. references/search-tuning.md behandelt alle drei Punkte und was zu exportieren ist.

6. Platzieren Sie Hinweise dort, wo die Entscheidung getroffen wird. Ein guter Hinweis beantwortet eine Frage, die die Person bereits hat, in dem Moment, in dem sie die Wahl trifft, an dem Ort, an dem sie bereits sucht, leise und günstig. Der Pfeil neben der Tankanzeige eines Autos, der zeigt, auf welcher Seite sich der Tankdeckel befindet, ist das Vorbild. Lesen Sie references/routes-and-cues.md, bevor Sie einen Hinweis oder einen personalisierten Einstiegspunkt hinzufügen.

7. Wenn jemand einen KI-Chat als Lösung vorschlägt, testen Sie ihn zuerst. Buttons und Menüs ermöglichen es den Leuten zu handeln und zeigen, was das System kann. Ein offenes Chatfenster tut ersteres langsam und zweiteres gar nicht.

   Situation	Bessere Antwort
   Eine begrenzte, bekannte Menge an Optionen	Buttons, Menüs oder Filter
   Die Leute wissen nicht, was das System kann	Sichtbare Struktur; eine leeres Feld lehrt nichts
   Eine wiederholte Aufgabe mit bekannten Schritten	Ein direkter Weg
   Der Inhalt fehlt oder ist falsch bezeichnet	Das zuerst beheben; Chat kann nicht abrufen, was nicht da ist
   Wirklich offen, jedes Mal anders formuliert	Chat kann sich seinen Platz verdienen, mit Struktur darum herum

8. Legen Sie Messgrößen fest, die Sie tatsächlich erfassen können. Nehmen Sie einen Ausgangswert auf, bevor Sie etwas ändern, eine Messgröße pro Problem. Wenn es keinen Ausgangswert gibt, sagen Sie das.

   Messgröße	Stammt von	Ziel
   Zeit zum Finden eines einfachen Elements	Ein zeitgesteuerter Aufgabentest mit Personen	Unter 30 Sekunden
   Aufgabenerfolg	Ein Aufgabentest oder Tree-Test	Mindestens 70 %, bei Top-Aufgaben 80 %
   Null-Ergebnis-Anteil der Suchen	Suchprotokoll	Unter dem eigenen Ausgangswert
   Suchausstiege, Umformulierungen	Analyse, falls die Ergebnisseite getrackt wird	Unter dem eigenen Ausgangswert
   Supportvolumen zu diesem Thema	Helpdesk, falls getaggt	Unter dem eigenen Ausgangswert

   references/measures.md erklärt, was jede Messgröße zeigen kann und was nicht.

Ergebnis

Schreiben Sie findability-diagnosis.md, es sei denn, der Benutzer nennt eine andere Datei, in dieser Reihenfolge: Empfehlung (zwei oder drei Sätze); Die Fehlschläge als Aufgaben; Belege (Quelle, Zeitraum, Zahlen aus dem Skript); Diagnose (Sache, Ursache, Beleg, bestätigt oder erschlossen); Optionen (zwei oder drei, mit jeweiligen Kosten und was ungelöst bleibt); Maßnahmenliste in der richtigen Reihenfolge mit der jeweils zuständigen Skill; Best Bets und Synonyme (query, action, target); No-Results-Seite, falls relevant; Messgrößen (Name, Ausgangswert, Ziel, Quelle, Datum der erneuten Prüfung); Annahmen und was nicht verfügbar war.

Auftrag	Herausgeben
Eine Sache, die niemand findet	Fehlschlag, Ursache, Beleg, Behebung und eine Messgröße, in der Antwort
Ein zu lesendes Suchprotokoll	Belege, Best Bets und Synonyme sowie die Null-Ergebnis-Lücken
„Die Auffindbarkeit ist auf der gesamten Website schlecht“	Das vollständige Dokument

Setzen Sie lange Tabellen an das Ende. Ein längeres Dokument ist nicht gründlicher.

Prüfen Sie es

• Jede Zahl geht auf einen Skriptlauf oder eine Quelle zurück, die der Benutzer Ihnen gegeben hat. Führen Sie das Skript erneut aus, wenn sich das Protokoll geändert hat.
• Jede Behebung nennt die Ursache, die sie adressiert, und jede Ursache hat einen Beleg oder ist als erschlossen markiert.
• Sie haben die Top-Anfragen selbst ausgeführt, wenn Sie Zugriff hatten, da das Protokoll nicht sagen kann, ob die Ergebnisse gut waren.
• Sie haben überprüft, dass jedes vorgeschlagene Synonym dasselbe bedeutet. Das Skript gruppiert nach Schreibweise und kann daher Wörter mit unterschiedlicher Bedeutung zusammenfassen.
• Suchprotokolle können Namen und E-Mail-Adressen enthalten, die in das Feld eingegeben wurden. Das Skript verbirgt E-Mail-Adressen; kopieren Sie keine anderen persönlichen Details in den Bericht.

Was Claude hier nicht kann

Sie können keine echten Personen beim Suchen beobachten, sie zeitlich messen oder die Strategie der Organisation kennen, es sei denn, es wird Ihnen mitgeteilt. Erfinden Sie niemals Nutzungszahlen, Suchvolumina, Erfolgsraten oder Zitate; eine Messgröße ohne Daten wird als noch nicht erhoben ausgewiesen. Schlagen Sie Alternativen mit ihren Kompromissen vor, empfehlen Sie eine und begründen Sie Ihre Wahl; die Entscheidung liegt beim Menschen. Was ein Suchprodukt kann (Synonyme, gepinnte Ergebnisse, Protokollierung von Anfragen), variiert; sagen Sie daher, was Sie erwarten würden, und bitten Sie den Benutzer, dies zu bestätigen.

Übergabe an andere Skills

Nächster Bedarf	Skill
Herausfinden, was existiert	content-inventory
Der Name ist falsch	labeling
Begriffe und Filter benötigen Überarbeitung	taxonomies
Die Gruppen entsprechen nicht der Denkweise der Leute	card-sort
Der Weg dorthin fehlt	navigation, sitemaps
Testen einer geänderten Hierarchie	tree-tests
Für Facetten oder Vorschauen benötigte Felder	content-models
Eine Seite wird verschoben	url-structure, redirect-maps
Komplette Umstrukturierung der Website oder unsicher, wo anfangen	information-architecture