hig-components-search

hig-components-search skill の概要

hig-components-search は、ナビゲーション要素の多いインターフェースで検索フィールド、ページコントロール、パスコントロールを設計するための Apple HIG skill です。hig-components-search skill は、「アプリ内で検索はどう動くべきか」「ページネーションのコントロールはどこに置くべきか」「ユーザーを混乱させずに階層をどう見せるべきか」といった問いに、実用的な答えが必要なときに使います。UI デザイナー、プロダクトチーム、そして search UX、search scopes、search suggestions、ディレクトリ型ナビゲーションについて HIG に沿ったガイダンスが必要なエージェントに特に役立ちます。

この skill が最も得意なこと

この skill が強いのは、見た目のスタイルだけでなく、コンポーネントの振る舞い、配置、ユーザーの期待に関わる課題です。search field、page control、path control のどれを使うべきか、その各要素が実際の UI でどう振る舞うべきかを判断するのに役立ちます。

インストールする価値がある理由

hig-components-search install の主な価値は、意思決定を支援できる点にあります。search を即時更新にすべきか、scopes が適切か、page control や path control がそもそも合っていないのか、といった迷いを減らせます。Apple HIG のナビゲーションパターンに出力をきちんと結びつけるため、汎用プロンプトよりも実用性が高くなります。

どんなときに向いているか

入力に search discovery、filtered results、paginated content、breadcrumbs、file hierarchy、ancestor navigation が含まれるなら、hig-components-search for UI Design を選ぶとよいでしょう。リスト、ライブラリ、カタログ、設定画面、ファイルブラウザ、あるいは構造化されたコンテンツを見つけたり移動したりする必要がある UI に向いています。

hig-components-search skill の使い方

skill をインストールしてコンテキストを読み込む

エージェント環境に hig-components-search をインストールし、デザインのガイダンスを求める前に skill context をモデルに渡します。典型的な hig-components-search usage の流れは、短いプロダクト概要とともに skill を呼び出し、その画面や機能に HIG ルールを適用させることです。

skill に適切な入力を与える

この skill は、コンテンツの種類、ユーザーの目的、ナビゲーションモデル、制約を具体的に書くほどよく機能します。たとえば「search design」ではなく、「live results があり、任意の category filtering を備え、advanced query syntax は使わない大規模ドキュメントライブラリ向けの search field」と依頼します。そうすることで、search field、scopes、tokens、empty-state の挙動のどれを選ぶべきかを判断するのに十分な文脈が伝わります。

先に読むべきファイル

まず skills/hig-components-search/SKILL.md を読み、次に references/search-fields.md、references/page-controls.md、references/path-controls.md を開いてください。この 3 つが、hig-components-search guide の実際の指針を最短で把握し、search パターンを pagination や hierarchy の用途に無理やり広げてしまうのを避けるための近道です。

うまくいくプロンプトの形

インターフェース、コンテンツ、必要な判断を明示したプロンプトにします。例: 「hig-components-search を macOS のファイルブラウザに適用してください。search の配置、scopes を使うべきかどうか、path control は standard か pop-up かを提案してください。」このようにすると、曖昧な依頼よりも、skill が一般的な UX アドバイスではなくコンポーネントレベルの指針で返しやすくなります。

hig-components-search skill の FAQ

hig-components-search は search fields だけの skill ですか？

いいえ。hig-components-search skill は page controls と path controls も扱うため、問題が単なる検索入力ではなくナビゲーション構造にある場合にも役立ちます。search、pagination、hierarchy 表示をチームが混同しやすい場面で特に重要です。

普通のプロンプトが書けるなら、この skill は不要ですか？

すでに HIG のルールを理解していて、短く確認したいだけなら、必須ではないかもしれません。Apple のナビゲーションコンポーネントの慣例に沿い、page controls を階層ナビゲーションのように扱うといった典型的な誤用を避けたいなら、hig-components-search をインストールする価値があります。

初心者デザイナーにも向いていますか？

はい。素早くよい初期判断をしたいなら向いています。search suggestions、scope controls、path controls のどれを使うべきか迷っている初心者に特に有用で、パターンを推測させるのではなく、具体的な判断フレームを与えてくれます。

どんなときは使わないほうがいいですか？

ブランディング、装飾的なビジュアル、一般的なレイアウトシステムには hig-components-search を使わないでください。また、高度にカスタムされた search logic、enterprise 向けの filtering taxonomy、あるいは Apple HIG パターンから意図的に外れる挙動が必要なプロダクトにも向いていません。

hig-components-search skill を改善する方法

先に判断材料を出す

最も良い結果は、プラットフォーム、コンテンツ密度、ユーザーが search しているのか、browse しているのか、階層を移動しているのかを含めた入力から得られます。たとえば「iPad app、20,000 items、live search、任意の scope buttons、入力に応じて results list を更新」のように書きます。「search を改善して」よりずっと良いのは、skill が適切な interaction model を選べるからです。

制約と不向きな条件を明確にする

インターフェースが即時更新できない、scopes が限られている、階層が浅い、といった条件があるなら、はっきり書いてください。そうした制約によって、hig-components-search が immediate search、tokens、あるいはより単純なパターンのどれを勧めるべきかが変わります。事前に伝える情報が多いほど、出力が推測に頼りにくくなります。

1 つの具体的な画面から反復する

最初の回答のあと、製品全体ではなく特定の画面について refinement を求めてください。よい続きの依頼は、「empty states、default scope、macOS での ancestor navigation を踏まえてこれを修正してください」のような形です。問題が絞られることで、提案の実用性が上がることが多くなります。

よくある失敗パターンに注意する

ありがちなミスは、search scopes の使いすぎ、フラットでないナビゲーションに page controls を使うこと、empty states や result feedback を十分に指定しないことです。最初の答えが一般的すぎると感じたら、hig-components-search をもう一度実行し、正確な content model、結果数、ユーザーの次の行動を明示してください。