hig について
higは、AppleのHuman Interface Guidelinesをローカルで検索できる資料です。システムUI、アクセシビリティ、操作性、審査上の規約を調べる開発者向けで、ビジュアルデザインの方向性は示しません。
主な機能
- 01ローカルで検索できるHIG文書
- 02システムコンポーネントと規約の参照
- 03アクセシビリティと操作性の情報
- 04App Review規約の参照
活用シーン
- 01タップ領域の最小サイズの確認
- 02Dynamic Typeとコントラストの調査
- 03システムコントロールの指針の検索
- 04App Review規約の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ prisma-labs-dev/ apple-skills --skill higインストール後、Claude Code で/higを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
accessibility.mdaccessibility.videos.mdaction-sheets.mdactivity-views.mdalerts.mdalerts.videos.mdapp-icons.mdapp-icons.videos.mdbuttons.mdbuttons.videos.mdcharts.mdcolor.mddesigning-for-ios.mdfeedback.mdhig-index.mdhome-screen-quick-actions.mdlaunching.mdlayout.mdlists-and-tables.mdmaterials.mdmaterials.videos.mdmenus.mdmodality.mdmotion.mdnavigation-bars.mdonboarding.mdpickers.mdplaying-haptics.mdplaying-haptics.videos.mdpopovers.md詳細
Human Interface Guidelines リファレンス
Apple の Human Interface Guidelines をローカルで検索できるようにしたコピーです。オンデマンドで事実を調べるためのものであり、デザインの指針ではありません。
事実に関する質問への回答に使用してください。システムコンポーネントでできること、Apple が何と呼んでいるか、アクセシビリティや人間工学上の最小基準(44pt のタップ領域、Dynamic Type の動作、コントラスト)、App Review で実際に確認される規約などです。
リポジトリのビジュアルデザインは、デザインを行うモデル自身の好みに基づきます。 HIG は事実の確認にのみ参照し、見た目の判断には使わないでください。HIG が説明するのはシステムが提供するものや求めるものであり、画面をどのように見せるべきかではありません。
ダウンロード済みのリファレンスファイル
主要な HIG ドキュメントはすべてローカルで利用できます(grep で検索可能です)。
はじめに
| ファイル | 内容 | サイズ |
|---|---|---|
| hig-index.md | HIG の完全な目次 | 11KB |
| designing-for-ios.md | iOS のデザイン原則 | 5KB |
基礎
| ファイル | 内容 | サイズ |
|---|---|---|
| app-icons.md | アプリアイコンのデザインガイドライン | 14KB |
| color.md | 色の使い方とシステムカラー | 17KB |
| typography.md | フォント、テキストスタイル、Dynamic Type | 17KB |
| layout.md | レイアウトの原則、安全領域 | 21KB |
| materials.md | マテリアル、ぼかし効果、ビブランシー | 14KB |
| motion.md | アニメーションの原則 | 9KB |
| accessibility.md | アクセシビリティのベストプラクティス | 19KB |
| sf-symbols.md | SF Symbols の使い方 | 21KB |
パターン
| ファイル | 内容 | サイズ |
|---|---|---|
| onboarding.md | オンボーディングのフロー | 6KB |
| modality.md | モーダル表示 | 7KB |
| launching.md | アプリの起動時の体験 | 6KB |
| feedback.md | ユーザーフィードバックのパターン | 5KB |
| playing-haptics.md | 触覚フィードバック | 10KB |
| searching.md | 検索パターン | 7KB |
| settings.md | 設定のパターン | 7KB |
コンポーネント - ナビゲーション
| ファイル | 内容 | サイズ |
|---|---|---|
| tab-bars.md | タブバーのデザイン | 11KB |
| navigation-bars.md | ナビゲーションバーのパターン | 17KB |
| toolbars.md | ツールバーのデザイン | 17KB |
| sidebars.md | サイドバーのパターン | 8KB |
コンポーネント - 表示
| ファイル | 内容 | サイズ |
|---|---|---|
| sheets.md | シート表示 | 11KB |
| alerts.md | アラートダイアログ | 10KB |
| action-sheets.md | アクションシート | 4KB |
| menus.md | メニューのデザイン | 14KB |
コンポーネント - コントロール
| ファイル | 内容 | サイズ |
|---|---|---|
| buttons.md | ボタンのスタイルと使い方 | 17KB |
| lists-and-tables.md | リストとテーブルのパターン | 9KB |
| toggles.md | トグル/スイッチのデザイン | 9KB |
| pickers.md | ピッカーコントロール | 6KB |
| sliders.md | スライダーコントロール | 6KB |
| steppers.md | ステッパーコントロール | 2KB |
| text-fields.md | テキスト入力フィールド | 6KB |
ドキュメントの検索
# Find color guidance
grep -i "semantic" color.md
# Find button styles
grep -i "bordered" buttons.md
# Find haptic patterns
grep -i "notification" playing-haptics.md
# Browse the full HIG index
grep -i "navigation" hig-index.md
ドキュメントの追加取得
- まず、このスキルのローカル
.mdファイルを検索します。 - 話題に関する内容が見つからない場合は、利用可能な他のインストール済み Apple スキルを、名前、説明、または
SKILL.mdのフロントマターで確認し、そのローカルファイルを grep で検索します。新しいドキュメントをインターネットから取得するより速く、コンテキストの使用量も抑えられます。 - 該当するページがインストール済みのスキルにない場合は、関連する Human Interface Guidelines のパスを
sosumi.aiの Markdown ミラーで参照します。たとえば、/design/human-interface-guidelines/buttonsはhttps://sosumi.ai/design/human-interface-guidelines/buttonsに対応します。
HIG ドキュメントの一般的なパス
| トピック | URL パス |
|---|---|
| 全インデックス | human-interface-guidelines |
| iOS のデザイン | human-interface-guidelines/designing-for-ios |
| iPadOS のデザイン | human-interface-guidelines/designing-for-ipados |
| macOS のデザイン | human-interface-guidelines/designing-for-macos |
| アプリアイコン | human-interface-guidelines/app-icons |
| 色 | human-interface-guidelines/color |
| タイポグラフィ | human-interface-guidelines/typography |
| レイアウト | human-interface-guidelines/layout |
| アクセシビリティ | human-interface-guidelines/accessibility |
| SF Symbols | human-interface-guidelines/sf-symbols |
| ボタン | human-interface-guidelines/buttons |
| タブバー | human-interface-guidelines/tab-bars |
| ナビゲーションバー | human-interface-guidelines/navigation-bars |
| シート | human-interface-guidelines/sheets |
| アラート | human-interface-guidelines/alerts |
基本情報
システムボタンのスタイル(iOS)
システムが標準で提供するスタイル:
- プレーン - テキストのみで、視覚的な主張は最小限です
- グレー - グレーの背景です
- 色付き - アクセントカラーの背景です
- 塗りつぶし - 単色の背景です
- 枠線付き - 枠線で囲まれています
- 強調枠線付き - 塗りつぶされた背景で、強く目立ちます
触覚フィードバックの種類
- 選択 - 選択内容の変更時に軽くタップします
- 衝撃 - 衝突時に軽い/中程度/強い/硬い/柔らかいフィードバックを返します
- 通知 - 結果に応じて成功/警告/エラーを知らせます
セーフエリア(操作性に関する情報)
- セーフエリア外のコンテンツは、ノッチ/Dynamic Island、ホームインジケータ、または角丸によって切り取られることがあります
- セーフエリア外のインタラクティブ要素にはアクセスできない場合や、システムジェスチャに遮られる場合があります
- 背景は、こうしたリスクなしに端から端まで広げられます
ソース
Apple のドキュメント
WWDC セッション
コメント
Markdown 対応