dickwu/apple-design-skill

Apple Design Skill – Apple風UIをAIで検証するツール

何であるか – Claude Code、Cursor、Codex、OpenCode、Windsurfなど、AIコーディングアシスタント向けのプラグイン（skill）です。このスキルにより、アシスタントがAppleのHuman Interface Guidelines（HIG）に基づいてUIを設計レビューできるようになります。Flutter、React Native、Tauri、Electron、SwiftUI、UIKit、AppKitなど、多数のフロントエンドフレームワークに対応し、選択したフレームワークの言語で具体的な修正案を提示できます。

動作方法 – リポジトリには以下の内容が含まれます：

• Apple公式HIGページから生成された122個のMarkdownファイル（原文の表現、見出し、表、変更履歴を完全に保持）。
• 最新のHIGページを再ダウンロードし、これらのMarkdownファイルを再生成するための小さなNodeスクリプト（scripts/pull-hig.mjs）。
• アgentの「姿勢」、レビューチェックリスト、レポート形式、およびオプションのimprovement mode（デザイントークンシステム：パレット、タイポグラフィ、モーションなど）を定義するSKILL.md。
• リクエスト（例：「私のFlutterのホームスクリーンをレビューして」）を関連するHIGページにマッピングするルーティングテーブル（references/hig-lookup.md）。

アシスタントが設計レビューのプロンプトを受け取ると、該当するHIGのMarkdownを読み込み、以下の手順で検証を行います：

1. Appleの8つのデザイン原則（目的、主体性、責任、親しみやすさ、柔軟性、シンプルさ、職人技、喜び）を確認。
2. アクセシビリティの数値（テキストスケーリング、コントラスト、コントロールサイズ、VoiceOver、キーボード操作、モーション設定）を検証。
3. プラットフォーム固有の規則（タブバー、メニュー、セーフエリア、ショートカットなど）を確認。
4. 視覚的職人技（色、フォント、レイアウト、アイコン、モーション、『視点』）をレビュー。
5. インタラクションパターン（ローディング、アラート、元に戻す、破壊的アクション）を検討。
6. コンテンツと文章（ラベル、大文字表記、エラーメッセージ）を確認。

各発見は 何が問題か、なぜ問題か（正確なHIGの見出しを引用）、および修正案（開発者が使用するフレームワークの言語で記述）として返されます。専用のサブモードでは、アプリアイコン、ダークモード、「Liquid Glass」エフェクト、オンボーディング、権限、フォーム、生成AIコンポーネント、単一UIコンポーネントなどもカバーしています。

インストール方法 – スキルは汎用的なskills CLI経由で配布されています：

npx skills add dickwu/apple-design-skill          # すべての対応アシスタントにインストール
npx skills add dickwu/apple-design-skill -a claude-code   # Claude Code専用
npx skills add dickwu/apple-design-skill -g               # ユーザー単位のインストール

ClaudeやCursor、Windsurfなどのアシスタントがローカルの.claude/skills/、.cursorrules、.windsurfrulesなどを読み込む場合、リポジトリを直接該当フォルダにクローンすることも可能です。

通常の使い方 – アシスタントとのチャットで、たとえば以下のようにリクエストします：

• 「私のFlutterアプリのホームスクリーンをAppleのガイドラインに従ってレビューして。」
• 「このTauriアプリのアクセシビリティを監査して。」
• 「このmacOSの設定ウィンドウはプラットフォームの規則に従っていますか？」
• 「iOSのパターンを壊さずに、このUIに『視点』を与えて。」 アシスタントは構造化されたレビューと具体的なコードレベルの提案を返します。

データの最新化 – 添付されたスクリプトを実行してください：

node scripts/pull-hig.mjs   # Node 18+が必要

このスクリプトはdeveloper.apple.comに約150回リクエストを行い、references/hig/*.mdファイルを再書き換え、ルックアップテーブルを更新します。スクリプトは決定論的であり、2回目の実行では変更が生じません。

ライセンスと出典 – プロトコルテキストはAppleの公開されたHuman Interface Guidelinesから再現されており、すべての生成ファイルに出典が明記されています。このリポジトリはAppleと関係ありません。コードとスキルは、リポジトリのライセンス（リポジトリ内のLICENSEファイルを参照）に基づき「現状のまま」提供されます。

---

結論 – Apple Design Skillは、汎用的なLLMベースのコーディングアシスタントを、複数の開発フレームワークでAppleのデザイン基準を強制する専門的なUIデザイン監査者に変えるツールであり、最新の参考資料と実行可能なフレームワーク固有の修正案を提供します。