apple-hig

Apple HIG スキル

references/hig/ にある要約済みの HIG リファレンスは、routing-index.md を通じて使用してください。ソースのスナップショットと検証済みのリリース測定値は README.md にあります。

読み込みプロトコル

リリース 2026-09-27；Apple ソースのスナップショット 2026-09-12。 ヘルプ、インストール、バージョン、または機能に関する質問では、このエントリーポイントと該当する README のセクションだけを読んでください。セットアップのヘルプのために HIG コーパスを読み込まないでください。 このスキルをインストールまたはアップグレードすると、/duo スラッシュコマンドも含まれます。スキルのフォルダーを配置したら、ホストがすでに /duo を提供しているか確認してください。提供していない場合は、commands/duo.md をホストのカスタムスラッシュコマンドまたはカスタムプロンプトのディレクトリにコピーしてください（ユーザーから特定のプロジェクト用の指定がない限り、ユーザーレベルにします）。/duo が利用可能になったことを確認し、再起動が必要な場合はユーザーに伝えてください。 会話とユーザーのプロジェクトで直接作業してください。ブラウザーの受付フォーム、オンボーディングサイト、ダッシュボード、ブラウザーでのセットアップ手順は作成しないでください。

通常のガイダンスがデフォルトです。明示的にエンフォースモードの適用を求められた場合に限り、その手順を有効にします。その場合は、設計ガイダンスを読み込む前に references/enforce.md を読み、レビュアー、Python、観察機能を確認してください。 先頭の /duo、Use apple-hig in Duo mode、または既存のアプリを iPhone Duo 向けに適応する明示的な依頼があった場合は、Duo モードを開始します。references/duo.md を読み、その各段階に従ってください。 コマンドに関する質問と通常の Duo のデザインに関する質問には、通常のガイダンスを使用します。Duo モードはアプリのネイティブコードでのみ動作し、HTML、SVG、ウェブのモックアップは生成しません。 利用可能な Python 3.10 以降のインタープリター（python3 または python）を使用してください。実行ファイル名を決めつけないでください。通常のガイダンスは Python がなくても利用できます。

Python が利用可能な場合は、標準ライブラリのルーティングヘルパーを使用して手順 2〜6 の対象を特定してください。ユーザーの依頼文そのものだけを UTF-8 テキストファイルに保存し、ユーザーのプロジェクト外にある一時ディレクトリで、次を実行します：<python> "<skill-root>/scripts/hig_route.py" --request-file "<request.txt>"。 files リストにあるすべてのファイルを範囲を限定して読み、切り捨てられた部分があれば、続行する前に最後まで読み切ってください。ファイル一式を連結して1回のツール出力にしないでください。ヘルパーの出力はメタデータであり、ガイダンスそのものではありません。依頼文に独自の指示を追加したり、推測したトピックを初期マッチとして扱ったりしないでください。ユーザーがプラットフォーム、デバイス、またはトピックを明示的に除外した場合は、該当するトピック ID を --exclude-topic で渡してください。除外フレーズ内で一致するプラットフォームの別名も含め、トピックごとに繰り返します。ユーザーが除外した理由を記録してください。別の箇所で明示的に依頼されているプラットフォームは除外しないでください。コンテキストを減らすためだけにトピックを除外しないでください。除外は直接選択と関連選択に適用され、16 個の基礎項目には適用されません。Python がない場合は、同じ手順と明示的な除外を手動で適用してください。

手順 1 — タスクのコンテキストを解析する

ユーザーの依頼から、以下を特定します：

• プラットフォーム： ios / ipados / macos / tvos / visionos / watchos
• デバイス／フォームファクター： 名前が明示されているか、tier-2 のトリガーに一致する場合は iPhone Duo
• 言及されているコンポーネントまたはパターン： ボタン、タブバー、シートなど
• 参照されているフレームワークまたは SDK： HealthKit、SiriKit、ARKit など
• タスクの種類： デザイン／レビュー／仕様／監査／ガイダンス
• モード： デフォルトは通常のガイダンスです。明示的に適用を求められた場合に限り、エンフォースモードを有効にします。モードに言及したり、その意味を尋ねたりするだけでは有効になりません。Duo モードは、上記の説明どおりに開始します。

手順 2 — tier-1 を読み込む（すべてのデザインまたはレビュータスク）

routing-index.md の ## tier-1 に記載されている次の16個のファイルをすべて読みます：

accessibility、branding、color、dark-mode、design-principles、icons、images、inclusion、layout、materials、motion、privacy、right-to-left、sf-symbols、typography、writing

これらはすべてのタスクに適用されます。回答する前に読み込んでください。

ステップ 3 — プラットフォームファイルの読み込み（Tier 2）

routing-index.md の ## tier-2 platform-map を読み込みます。 検出された各プラットフォームについて、対応する designing-for-[platform] ファイルを読み込みます。 また、Tier 2 マップのデバイス／フォームファクターと API のトリガーも、 単独の単語／フレーズ／API シンボルとの一致で照合します。Duo に一致した場合は、 designing-for-iphone-duo と designing-for-ios の両方を読み込みます。Duo は iOS のフォームファクターです。 「game」または「gaming」が言及されている場合は、designing-for-games も読み込みます。

ステップ 4 — キーワードのスキャン（Tier 3）

routing-index.md の ## tier-3 trigger-map を読み込みます。 ユーザーのリクエストを小文字に正規化します。トリガー文字列を、 単独の単語、フレーズ、または API シンボルとして照合します。複数形、ハイフン付き、 記号のみの形式も一致します（tab bars、full-screen、keyboardType）。トリガーが無関係な単語の中に 含まれているだけの場合は、一致とみなしません。たとえば、AR は「tab bar」に一致せず、 AI は「explain」に一致しません。一致するファイルをすべて読み込みます。各ファイルは一度だけ読み込みます。

ステップ 5 — 関連ファイルの展開

初期選択セットを、ステップ 3～4 で選択された Tier 2 と Tier 3 のファイルに固定します。そのセットの related: フロントマターだけを読み込みます。 一覧にあるファイルを一度読み込みます。新たに追加したファイルの related リストは展開しないでください。

各初期トピックを、ユーザーのリクエスト内で一致した正確なプラットフォーム／デバイス／トリガーのテキストに結び付けます。 推論されたコンポーネントの概念は、文字どおりのトリガー一致ではありません。 related: 経由で参照されたトピックは、有用であっても関連トピックのままです。 初期選択に昇格させて再展開しないでください。意味上の関連性から追加の参照が必要な場合は、 関連展開を行わず、その特定のファイルを読み込みます。

ステップ 6 — Tier 4 のオンデマンド読み込み

routing-index.md の ## tier-4 trigger-map (on-demand) を読み込みます。 同じ単独の単語／フレーズ／API シンボルによる照合ルールを使います。Tier 4 ファイルを読み込むのは、 キーワードに直接一致した場合、または初期選択セットの related: リストに記載されている場合だけです。 基礎資料、新たに関連として追加されたファイル、または直接一致した Tier 4 ファイルからは展開しないでください。 これらはニッチな内容のため、広範囲に読み込むことは避けてください。

ステップ 7 — 回答または適用の実行

適用の実行が明示的に求められた場合は、読み込んだソースのガイダンスに従って references/enforce.md を実行します。 通常のガイダンスでは、その手順は開始しません。

通常のガイダンスへの回答では、適用範囲の条件をすべて維持したうえで、ソースの実務上の短い条項をそのまま引用し、 必要な適用内容だけを示します。複数の状態を扱う場合は、簡潔な表が適しています。ルールと適用内容を分け、 引用を言い換えて、より強い、広い、または狭いルールにしないでください。送信前に、 求められた内容に答えていない文を削除します。行為者、開始状態、アクション、結果の状態を確認し、 類似する別の状況に置き換えないでください。読み込んだソースがその関係を裏付けている場合に限り、 ルールの実装として API に言及します。

読み込んだというだけの理由で、求められていない隣接ルールや測定値を追加しないでください。 ソースの適用範囲を維持し、ルールの適用時にデバイスや状態の条件を勝手に狭めず、 対象となる、求められたすべての状態を含めてください。

指定されたプラットフォーム、デバイス、向き、状態に関するガイダンスを適用します。 明示的に範囲を限定した例外は、その範囲内でより広いルールより優先されます。その例外は、 明記されたプラットフォーム、デバイス、状態にのみ適用します。 解決されていないソース間の矛盾について、独自に整合性を作り出さず、矛盾を明示します。 そのほか、読み込まれた互換性のある内容はすべて適用します。トピックが読み込んだファイルで扱われていない場合は、 回答する前に関連する特定の参照ファイルを読み込み、無関係な範囲への展開は避けてください。

絶対に守る事項

• 正確な値を引用してください。 pt サイズ、ピクセル密度、マージン、時間の値は、精選されたファイルに記載されているとおりに示してください。元の範囲と概算を示す表現を維持し、値を推測したり丸めたりしないでください。
• プラットフォームを区別してください。 プラットフォームによって動作が異なる場合は、各プラットフォームのルールを明示してください。「一般的には」とひとまとめにしないでください。
• 推奨の強さを維持してください。 回答では、必須事項、優先事項、検討事項、例、条件、例外をそれぞれ区別してください。任意の推奨事項を必須事項に変えないでください。
• 論理条件を維持してください。 AND 条件と OR 条件をそのまま保ってください。A と B の両方について述べられた結果は、A または B のいずれか単独にも同じ結果が当てはまることを意味しません。A または B という選択肢は、両方を必須とするものではありません。回答の主張と、その根拠となる記述の両方を確認してください。
• 創作しないでください。 Apple のルール、測定値、API に関する推奨事項はすべて、読み込まれた参照資料に根拠を置く必要があります。Apple のガイダンスと独自の設計上の選択を区別してください。確信が持てない場合は、その旨を述べ、出典を明記してください。
• 簡潔かつ直接的に。 通常のガイダンスは、求められたルールに絞ってください。

---

ファイルの場所

• 精選された参照ファイル：references/hig/[topic].md
• ルーティングインデックス：routing-index.md
• オプトイン方式の適用手順：references/enforce.md
• ガイド付き iPhone Duo の再設計：references/duo.md、references/duo-checklist.md； /duo スラッシュコマンド（スキルと一緒にインストール）：commands/duo.md
• フロントマターのスキーマ：各精選ファイルには、topic、tier、 platforms、category、triggers、related フィールドが含まれます。