Communitygithub.com

Bushnell — 即時の価値と持続的な深み

初心者には即座に価値を提供し、経験を積んだユーザーには意味のある深みを与えるプログレッシブ・ディスクロージャーを設計します。ドリルダウン、階層型ビジュアライゼーション、ナビゲーション、ダッシュボード、繰り返し使用される体験に適用し、初回の遭遇と100回目の使用の両方を評価します。

Bushnell — 即時の価値と持続的な深み とは?

このスキルは、Bushnellの法則(習得は容易だが熟達は困難)を製品デザインに応用するための原則と実践手法を提供します。主な目的は、初めてのユーザーが数秒で価値を理解でき、かつ何度も使ううちに新たな発見や熟達が得られるような段階的な情報開示(ディスクロージャーラダー)を設計することです。このスキルは、初期画面、詳細表示、調査、根拠、内部機構という5つのレイヤーを定義し、各レイヤーが異なる質問に答え、異なるアクションをサポートするよう求めます。具体的には、チャート、ダッシュボード、ナビゲーション、設定画面、データ探索ツールなど、繰り返し使用されるUIコンポーネントの設計に適しています。ワークフローとして、ユーザージャーニーの特定、初回報酬と100回目報酬の定義、インタラクションコントラクトの明示化、実装パターンの再利用、新規ユーザーとリピーターユーザーの両方の視点でのレビューを推奨しています。Claude CodeやCursor、CodexなどのAIエージェントがUIデザインの指示を解釈・生成する際に、このスキルの原則を適用することで、表面的な装飾ではなく、ユーザーの理解と熟達を促進する本質的なデザインを実現できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jwexler10/bushnell-skill/tree/HEAD/skills/bushnell

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Bushnell — 即時の価値、持続的な深み

一般にBushnellの法則と呼ばれるデザイン原則を適用します。習得は容易、熟達は困難。製品にとってこれは、数秒で理解され、繰り返し使用することで報われることを意味します。熟達はインターフェースを解読することからではなく、より深い理解から生まれます。

このスキルを使用して、深みがどのように展開するかを設計します。まず機能の目的と基本的な使いやすさを確定してください。コンパニオンスキル、コンポーネントライブラリ、リポジトリレイアウトは必要ありません。

両方の報酬を定義する

初回遭遇時の報酬: 新しいユーザーが最初の数秒間で理解したり得たりするもの。コントロールを学んだり詳細を探ったりする前の段階。チャートは即座に傾向を可視化し、作成ツールは有用な開始結果を提供するかもしれません。

100回目の使用での報酬: 慣れた後も意味を持ち続けるもの。有用な源泉には、より高い精度、馴染みのあるオブジェクト間の新しい関係、主張の背後にある証拠、表現力豊かな組み合わせ、ユーザー自身のデータや作業の変化などが含まれます。

同じ要約を異なるサイズで2回提供しないでください。より深いレイヤーは、新しい質問に答えるか、新しいアクションをサポートしなければなりません。

ディスクロージャーラダーを構築する

初期画面は、よくある質問に答えます。明示的で発見可能なアクションにより、あまり一般的でない質問が開かれます。分割はユーザーのニーズに基づいて行い、バックエンドのデータ保存方法に基づいてはいけません。

レイヤー適切なコンテンツ設計上の責務
初期画面主な結果、主要な可視化、必須のステータス探索的操作なしで価値を伝える。
要求に応じた精度正確な値、定義、比較ポインター、キーボード、タッチアクセスを適切にサポートする。ホバーだけに必須情報を依存させない。
調査メンバー、例、関連オブジェクト、編集可能な詳細トリガーとその結果を予測可能にする。
根拠または方法出典、計算、不確実性、制限事項メインタスクを圧倒することなく、利用可能で理解しやすい状態を保つ。
内部機構実装専用のスコアや識別子ユーザーのタスクに役立つ場合にのみ、意味のあるラベルを付けて公開する。

これらは役割であり、強制されるウィジェットではありません。セクションを折りたたむこと自体が深みを生むわけではありません。初期コンテンツが有用であり、開示されたコンテンツが意味のあるフォローアップの質問に答える場合にのみ役立ちます。

原則を再帰的に適用する

何層にもわたる機能であっても、理解可能なエントリポイントと探索する理由が必要です。例:

概要 -> グループを選択 -> メンバーを調査 -> 裏付け証拠を調査

各遷移は、方向性を維持しながら理解を深めるべきです。より多くの好奇心が必要になることはあっても、より多くのインターフェース知識が必要になるべきではありません。

深みは、理解しやすい要素間の意味のある関係から生まれます。パネル、コントロール、または作られた用語の数からではありません。図の視覚的文法は、証拠がサポートできない因果関係などの関係性を暗示してはなりません。

インタラクション契約を明示的にする

  • 競合するジェスチャを解決する。 選択、ドラッグ、背景クリック、検索、ナビゲーションが共存する場合に何を行うかを定義します。誤操作を避けます。
  • コンテキストを保持する。 より深いレイヤーは、親を保持するか、関連する状態を維持したまま戻る明確な方法を提供する必要があります。隣接パネル、パンくずリスト、スタック、またはデバイスとタスクに適したその他のパターンを使用します。
  • 尋ねられた質問に答える。 グループ内のアイテムを選択した場合、そのアイテムをそのコンテキストで説明する必要があります。そのより広い履歴は別のパスとして提供します。
  • 確立されたコンテナを再利用する。 別のナビゲーションシステムを導入する前に、既存の詳細パターンに新しい対象を追加します。
  • 意図的に開示する。 珍しい質問に答えるために、表面を支配する恒久的なコールアウトは避けます。
  • 正直に折りたたむ。 省略されたカウントやスコープを示します。リストを展開しても、既に表示されている情報の意味や規模が黙って変わってはいけません。
  • 復帰を可視化する。 関連する場合、閉じる、戻る、リセット、または元に戻すを提供します。ユーザーがリセットを選択しない限り、意図的な調整は保持します。

正確なレイアウトとジェスチャは、アクセシビリティのニーズと利用可能なスペースに適応させます。デスクトップの配置は、小さな画面では必須ではありません。

システムが作り出す振る舞いを設計する

機能が許可することだけでなく、人々が何をするかを尋ねます:

機能チェックすべき振る舞い
クリック可能なデータポイント目的のないパネル開封ではなく、意図的な調査。
検索不要なナビゲーションや状態変更ではなく、方向付け。
ドラッグ、パン、ズーム信頼できる帰路を備えた、より明確なビュー。
複数の詳細レイヤーコンテキストを保持しながら理解を蓄積。
カスタマイズ設定を前提条件にせず、有用な制御。
深いナビゲーションユーザーが作業を失わずに戻れるという確信。

実際の使用が意図した振る舞いと矛盾する場合は、デザインを修正します。復帰と継続性は、探索を可能にする条件です。

馴染みのないアイデアを読みやすくする

内部的な単位ではなく、指示対象に名前を付けます。「説明のないスコア」よりも「通常の週間合計の1.4倍」を優先します。形容詞は、それを支える数量と比較に結びつけておきます。馴染みのない用語は、必要な場所で定義します。

証拠が乏しい場合は、その旨を明示します。裏付けのない結論でギャップを埋めてはいけません。オプションの生成説明は、それ以外は有用な結果をブロックしてはいけません。必須の作業は、進捗、失敗、復帰を正直に伝える必要があります。

ワークフロー

  1. ユーザーの全体的なジャーニーの中で機能を特定します。誰がそれに遭遇するか、彼らが既に何を知っているかを特定します。利用可能な場合は既存の製品やコードを調査します。
  2. 初回遭遇時の報酬と100回目の使用での報酬を、それぞれ一文で記述します。
  3. 主要なアクション、それが開く質問、そして次の有用なステップをマッピングします。
  4. コンテンツをディスクロージャーラダーに割り当てます。学習を増やしても価値を追加しない重複する要約やコントロールを削除します。
  5. コンテキスト保持、ジェスチャ優先順位、アクセシブルなアクセス、復帰を指定します。
  6. 実装が要求された場合は、確立された実装パターンを使用します。
  7. 新人として一度、再来訪ユーザーとして一度レビューします。コントロールが技術的に機能するかどうかだけでなく、振る舞いも確認します。

概要には、即時の価値とより豊富な資料への明確な経路を優先します。中程度の深さの機能には、ユーザーの質問を中心に整理します。主張の背後にある証拠には、出典、範囲、不確実性、そして戻る経路を優先します。

避けるべきこと

  • 操作されるまで何も表示しない画面。
  • 必須の機能やアクセシビリティを発見に隠すこと。
  • コントロール、チャート、または設定を追加して、その結果を深みと呼ぶこと。
  • 通常の結果を理解するために内部用語を必要とすること。
  • 親を完全に置き換えて、ユーザーが尋ねた質問を失わせること。
  • バッジ、連続記録、または人工的なアンロックを意味のある価値の代替として扱うこと。
  • 現在のコンテキストを確認せずに、製品固有の制限やレイアウトを強制すること。

引き継ぎ時には、2つの報酬と発見経路に名前を付けます。説明をタスクに合わせてスケーリングし、現在の製品に関する主張を実際の観察やコード参照で裏付けます。

関連スキル