見つけやすさ（Findability）
「人が見つけられない」という症状には、通常4つの原因があり、それぞれに異なる修正方法が必要です。このスキルは、何を最初に変更するかの判断に役立ちます。原因を苦情から切り離し、それに対処する最も安価な修正を選び、それが機能したかどうかを示す測定基準を設定します。
始める前に
| 必要なもの | 不足している場合 |
|---|---|
| 何が、誰によって、どこで見つけられないのか | 質問してください。曖昧なままの場合は、候補をリストアップし、仮説として扱います。 |
| サイト、アプリ、または少なくともそのナビゲーション | 質問してください。それがなければ、診断計画しか書けません。 |
検索ログ（CSV形式）：query,count,results、可能であればclicks | 何をエクスポートするか、どの期間かを伝えてください。診断計画、測定基準、空のテーブルを提供します。ログが何を言っていたかを推測してはいけません。 |
| アナリティクス、サポート質問、インベントリ | それらがどの結論を変えるかを伝え、それらを未確認としてマークします。 |
方法
-
失敗をタスクとして書き出します。 「[誰]が[目標]を達成しようとして[場所]で[もの]を探し、[何が起こる]」。苦情ごとに一文で、その人の言葉で書きます。
-
ログを読み、その数値を使用します。
node "${CLAUDE_SKILL_DIR}/scripts/search-log.mjs" searches.csvログが小さすぎてランキングできないと表示された場合は、人々が入力した単語のリストとして使用し、率は示さないでください。エクスポートがカバーする期間を伝えてください。スクリプトはそれを知ることができません。
-
処方箋を書く前に診断します。 原因を次の順序で検討します。それぞれが前の原因に基づいているためです。複数の原因が同時に当てはまることがあります。各結論は確認済みまたは推測とマークします。
原因 確認方法 通常の修正 スキル 存在しない: それが存在しない 人々が使うすべての名前で探す。一致するコンテンツがどこにもないゼロ結果クエリ 作成するか、提供されていないと明確に言う content-inventory ラベルが悪い: 別の名前で存在する 彼らの言葉がゼロ結果またはクリックなしで、コンテンツはあなたの名前の下にある；ポゴスティッキング 名前を変更する、類義語を追加する labeling 埋もれている: 名前は良いが、そこへの経路がない ホームとハブからのステップ数を数える；孤立ページ、行き止まり、唯一の経路としての深いページネーション、それを提供すべきセクションページから検索が開始されているものを探す 人々がすでに探している場所にリンクするか、移動する navigation, sitemaps 検索が失敗している: 存在し、クエリは一致するが、結果が間違っている 上位クエリを自分で実行し、結果を読む；クリックがない結果、言い換え、結果ページからの離脱 ベストベット、類義語、インデックス範囲、ランキング ステップ5 多くの見つけやすさの問題は、検索エンジンよりもラベルとグループ分けの修正の方が安価です。そのため、エンジンから始めないでください。深さだけで欠陥とはなりません。3クリックルールは神話であり、各ステップが明確に目標に近づいているように見える場合、人々はさらにクリックします。
-
どの経路が機能するべきかを決定します。 ブラウズと検索の両方をサポートします。人々はそれらを切り替えるためです。上位クエリは、ホームから1～2ステップで到達可能であるべきです。
人物 強化する経路 正確な名前を知っている 検索、またはA to Zリスト ニーズは知っているが名前は知らない 明確なラベルでのブラウズ、その後ファセット 探索または比較している ブラウズ、フィルター、関連リンク 何かに戻ってくる 最近のアイテム、保存したビュー、ショートカット タスクの途中である 作業中の場所にあるコンテキストリンクまたはキュー -
原因が検索である場合は検索を修正します。 上位クエリに対して、キュレーションされたベストベットを結果の先頭に配置します。スクリプトのバリアントグループから類義語セットを構築します。
SYNONYM WOULD ANSWERとマークされたものから始め、頭字語や専門用語など、人間だけが見つけられるものを追加します。結果なしページを行き止まりにしないでください。references/search-tuning.md はこれら3つすべてと、エクスポートすべき内容をカバーしています。 -
決定が行われる場所にキューを配置します。 良いキューは、人がすでに持っている質問に、選択を行う瞬間に、すでに探している場所で、静かにかつ安価に答えます。車の燃料計の横にある矢印で給油口の位置を示すものがモデルです。キューやパーソナライズされたエントリポイントを追加する前に、references/routes-and-cues.md を読んでください。
-
誰かがAIチャットを修正策として提案した場合、まずテストします。 ボタンとメニューは人々に行動を促し、システムが何ができるかを示します。開かれたチャットボックスは、前者をゆっくりと、後者をまったく行いません。
状況 より良い回答 限られた、認識可能なオプションセット ボタン、メニュー、またはフィルター 人々がシステムに何ができるか知らない 可視構造；空のボックスは何も教えない 既知のステップを持つ反復タスク 直接的な経路 コンテンツが欠落または誤ってラベル付けされている それを最初に修正する；チャットはそこにないものを取得できない 真に自由形式で、毎回異なる表現 チャットは、それを囲む構造とともに、その地位を獲得できる -
実際に収集できる測定基準を設定します。 何かを変更する前にベースラインを取ります。問題ごとに1つの測定基準。ベースラインがない場合は、そのように述べます。
測定基準 入手元 目標 単純なアイテムを見つけるまでの時間 人を対象とした時間指定タスクテスト 30秒未満 タスク成功率 タスクテストまたはツリーテスト 少なくとも70％、上位タスクは80％ 検索におけるゼロ結果の割合 検索ログ 自身のベースライン以下 検索からの離脱、言い換え アナリティクス（結果ページが追跡されている場合） 自身のベースライン以下 このトピックに関するサポートボリューム ヘルプデスク（タグ付けされている場合） 自身のベースライン以下 references/measures.md は、各測定基準が何を示し、何を示さないかを説明しています。
成果物
ユーザーが別のファイル名を指定しない限り、findability-diagnosis.md を次の順序で作成します：推奨事項（2～3文）；タスクとしての失敗；証拠（ソース、期間、スクリプトからの数値）；診断（対象、原因、証拠、確認済みまたは推測）；オプション（2～3つ、各コストと修正されないものを含む）；修正リスト（順序付き、各修正を行うスキル付き）；ベストベットと類義語（query, action, target）；必要に応じて結果なしページ；測定基準（名前、ベースライン、目標、ソース、再確認日）；前提条件と利用できなかったもの。
| ジョブ | 引き渡すもの |
|---|---|
| 誰も見つけられない一つのもの | 返信の中で、失敗、原因、証拠、修正、および一つの測定基準 |
| 読むべき検索ログ | 証拠、ベストベットと類義語、およびゼロ結果のギャップ |
| 「サイト全体で見つけやすさが悪い」 | 完全なドキュメント |
長いテーブルは最後に配置します。文書が長いほど、より詳細であるとは限りません。
チェックリスト
- すべての数値は、スクリプトの実行またはユーザーが提供したソースに遡ります。ログが変更された場合はスクリプトを再実行します。
- すべての修正はそれが対処する原因を指名し、すべての原因には証拠があるか、推測とマークされています。
- アクセス権がある場合は、上位クエリを手動で実行しました。ログだけでは結果が良かったかどうかはわかりません。
- 提案された各類義語が同じ意味であることを確認しました。スクリプトはスペルでグループ化するため、意味が異なる単語をペアにする可能性があります。
- 検索ログにはボックスに入力された名前やメールアドレスが含まれることがあります。スクリプトはメールアドレスを隠します。他の個人情報をレポートにコピーしないでください。
Claudeがここでできないこと
実際の人が検索するのを見たり、時間を計ったり、指示がない限り組織の戦略を知ることはできません。使用数、検索ボリューム、成功率、引用を決して捏造しないでください。データがない測定基準は、まだ収集されていないものとして示します。トレードオフを含む代替案を提案し、一つを推奨して理由を述べます。決定は人間が行います。検索製品が何ができるか（類義語、固定結果、クエリログ）は異なるため、期待することを述べ、ユーザーに確認を求めます。
引き継ぎ先
| 次のニーズ | スキル |
|---|---|
| 何が存在するか調べる | content-inventory |
| 名前が間違っている | labeling |
| 用語とフィルターの改善が必要 | taxonomies |
| グループが人々の考え方と一致しない | card-sort |
| そこへの経路がない | navigation, sitemaps |
| 変更された階層のテスト | tree-tests |
| ファセットやプレビューに必要なフィールド | content-models |
| ページが移動する | url-structure, redirect-maps |
| サイト全体の再構築、またはどこから始めればよいかわからない | information-architecture |