dickwu/apple-design-skill

Apple Design Skill – AIを活用したApple HIG対応UIレビュアー

概要

• AIコーディングアシスタント（Claude Code、Cursor、Codexなど）に追加できる再利用可能なスキルです。
• このスキルにより、アシスタントがデザインレビュアーとして機能し、モバイルおよびデスクトップUIコードをAppleのヒューマンインターフェースガイドライン（HIG）に照らしてチェックできます。

仕組み

• リポジトリには、HIGページを直接コピーした123個のMarkdownファイル（厳選された「Liquid Glass」ガイドも含む）が同梱されています。各ファイルにはAppleの文言、見出し、表、変更履歴情報が保持されています。
• 小規模なNodeスクリプト（scripts/pull-hig.mjs）を使用して、developer.apple.comから最新のHIGページを再ダウンロードし、参照セットを最新の状態に保つことができます。
• エージェントが*「Flutter画面をAppleのガイドラインに照らしてレビューして」*などのリクエストを受け取ると、スキルは関連するHIGマークダウンを読み込み、構造化されたレビューを生成します。
  1. Appleの8つの設計原則
  2. アクセシビリティチェック（テキストスケーリング、コントラスト、コントロールサイズなど）
  3. プラットフォームの慣例（タブバー、メニュー、セーフエリアなど）
  4. ビジュアルデザインと品質
  5. インタラクションパターン
  6. コンテンツと文章スタイル
• 各指摘にはWhat（内容）、Why（正確なHIG見出しを引用）、および使用中のフレームワーク（Flutter、React Native、Tauri、Electron、SwiftUI、UIKit、AppKit）で記述されたFix（修正）が含まれます。
• 特別なモードでは、アプリアイコンレビュー、ダークモードチェック、iPhone Duoのデュアルスクリーンレイアウト、Liquid Glassエフェクト、生成AIで作成されたUIコンポーネントを処理します。

インストール

• 推奨される方法は、汎用のスキルCLIです。

  npx skills add dickwu/apple-design-skill   # サポートされているすべてのエージェントに追加
  

• 単一のエージェントを指定できます（-a claude-code、-a cursor、-a codex）。
• Claude Codeの場合、リポジトリを~/.claude/skills/apple-designにクローンすることもできます。
• Cursorやその他のエージェントは、リポジトリに同梱されている同じ.cursorrules / .windsurfrulesファイルを読み取ります。

一般的な使用法

エージェントに質問する：
- "Flutterアプリのホーム画面をAppleのガイドラインに照らしてレビューして"
- "このTauriアプリのアクセシビリティを監査して"
- "この設定画面はmacOSの慣例に従っていますか？"
- "私のアプリはiPhone Duoの2つのディスプレイに対応していますか？"
- "この一般的なUIに、iOSパターンを壊さずに視点を与えて"

エージェントは箇条書きのレビューで応答し、各項目で問題、HIG参照、選択したフレームワークの具体的なコードレベルの修正を説明します。

主要コンポーネント

• SKILL.md – スキルのスタンス、レンズ、レポート形式、改善ワークフローの定義。
• AGENTS.md – コントリビューターおよびサポートされている各AIエージェント向けの手順。
• scripts/pull-hig.mjs – AppleのJSON APIをクロールし、123のHIGページをreferences/hig/*.mdにレンダリングし、ルーティングテーブルを更新する、依存関係のないNodeスクリプト。
• references/ – 生成されたHIGマークダウンファイルと、クロスプラットフォーム変換テーブル（cross-platform.md）。

重要な理由

• Appleの常に変化するガイドラインに照らしてUIをチェックするという、退屈で詳細なプロセスを自動化することで、開発者の時間を節約します。
• Apple中心のデザイン言語とクロスプラットフォームUIツールキット（Flutter、React Native、Tauri、Electronなど）の間のギャップを埋めます。
• 簡単なnode scripts/pull-hig.mjsコマンドで参照資料を最新の状態に保ちます。

ライセンスと出典

• ガイドラインテキストはAppleの公開ヒューマンインターフェースガイドラインから複製されたものであり、プロジェクトが所有するものではありません。スキル、スクリプト、厳選ガイドはリポジトリのライセンスに基づいて「現状のまま」提供され、プロジェクトはAppleとは提携していないという免責事項が含まれます。

サポート

• 著者は、HIG取得スクリプトの保守とスキルの最新状態を維持するために、GitHub Sponsorsによるスポンサーシップを歓迎します。