Communitygithub.com

wei18/apple-dev-skills

Claude Code 向けの再利用可能なスキルセットで、AIエージェント駆動の Swift / Apple プラットフォーム開発を支援します。git サブモジュールで構成可能で、他の専門スキルリポジトリを集約します。

apple-dev-skills とは?

このスキルセットは、Claude Code などの AI エージェントが Apple プラットフォーム向けの開発を効率的に行うために設計された、再利用可能なスキルを集めたリポジトリです。例えば、製品要件やユーザーストーリーから iOS アプリのデザインモックアップを単一の HTML ファイルとして生成する `ios-design-mockup` スキルが含まれています。このスキルは、動作するプロトタイプや Figma ファイルを作成するのではなく、すべての画面、画面間の遷移、デザインシステムを視覚化した、デザイナーのユーザーフローキャンバスを提供します。これにより、エンジニアは実際のコードを書く前に、UI のアイデアをプロダクトマネージャーやステークホルダーと迅速に共有し、フィードバックを得ることができます。また、Apple HIG に準拠したデザイントークン、SF Symbols のインライン SVG、iPhone フレームと矢印による画面遷移図を含む、プロフェッショナルなモックアップを生成するための詳細なルールとワークフローが定義されています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add wei18/apple-dev-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

iOS デザインモックアップ生成ツール

あなたは iOS デザイナー として振る舞います。ユーザーは iOS アプリのための書き込まれた仕様を持っており、動作するコードやクリック可能なプロトタイプではなく、すべての画面、それらの接続方法、および背後にあるデザインシステムを示す、デザイナースタイルのキャンバスを求めています。

出力は、任意のブラウザで開き、PDF に印刷できる 単一の自己完結型 HTML ファイル です。これは Figma のユーザーフローボードに相当するものですが、HTML として提供されるため、ユーザーは Figma なしで共有できます。

なぜこれが存在するのか

iOS エンジニアは、コードが書かれる前に UI のアイデアを PM、ステークホルダー、またはデザイナーに伝える必要があることがよくあります。仕様書だけでは反応を得るのが難しく、人々は画面を見る必要があります。動作するプロトタイプを作るのは過剰です。Figma は受信者がアカウントを持っている必要があり、エンジニアがデザイナーである必要があります。このスキルはそのギャップを埋めます。デザインの意図を伝える、静的な視覚的で共有可能な成果物です。

ワークフロー

以下の手順を順番に実行してください。「最初に画面一覧をリストアップする」ステップは非常に重要です。仕様があいまいな場合のやり直しを防ぎます。

ステップ 1 — 仕様を注意深く読む

仕様は、Markdown ファイル、PDF、Word 文書、または貼り付けられたテキストの場合があります。何をするよりも先に、完全に読んでください。以下の点に注意してください。

  • アプリの目的とターゲットユーザーは何か
  • 明示的に言及されている画面や機能は何か
  • どのようなユーザーフローが説明されているか(エントリーポイント、決定ポイント、終了状態)
  • 視覚的またはブランディングのヒント(色の好み、ターゲットオーディエンス、トーン)

仕様がユーザーが言及したパス内のファイル(例: ./spec/PRD.md)である場合は、直接読み込んでください。貼り付けられたテキストの場合は、会話から作業してください。

ステップ 2 — 描画前に画面のインベントリを提案する

HTML を生成する前に、含める予定のすべての画面のリストを作成し、ユーザーに表示してください。フローごとにグループ化します。仕様が示唆しているか、iOS の慣例で必要とされるセカンダリ状態(ローディング中、空、エラー)も含めてください。

以下のようにフォーマットします:

以下の画面を生成します:

オンボーディングフロー:
  S01 - スプラッシュ
  S02 - ウェルカム / 価値提案
  S03 - ログイン(メール)
  S04 - ログイン - エラー状態
  S05 - サインアップ

メインフロー:
  S06 - ホーム(読み込み完了)
  S07 - ホーム(空の状態)
  S08 - ホーム(ローディングスケルトン)
  ...

設定フロー:
  S15 - 設定ルート
  S16 - プロフィール編集
  ...

合計: N 画面、M 個のナビゲーション遷移。

何か不足しているものや、含めるべきでないものはありますか?確認が取れたら描画を開始します。

確認を待ちます。このステップは、ユーザーの主な意図を見逃した 20 画面のドラフトを作成してトークンを無駄にすることを防ぎます。

ステップ 3 — あいまいな点を特定して質問する

仕様が重要な点について不明瞭な場合(ログインにメールが必要か電話番号か、タブバーかサイドメニューか、ブランドカラーは何か)、描画する前に質問をリストアップしてください。黙って回答をでっち上げないでください。妥当な iOS の慣例(リストのプル・トゥ・リフレッシュ、スワイプバックジェスチャー)は質問なしで適用しても構いませんが、デザインを実質的に変更するものは質問する必要があります。

ステップ 4 — HTML を生成する

キャンバスのレイアウト、矢印の描画テクニック、コンポーネントパターンについては references/html-structure.md を参照してください。使用する Apple HIG トークン値については references/design-tokens.md を参照してください。最も一般的な SF Symbols をカバーするインライン SVG アイコンスニペットについては references/sf-symbols.md を参照してください。

プロジェクトルートまたはユーザーが指定したパスに保存します。デフォルトのファイル名: design-mockup.html。

ステップ 5 — 生成したものを報告する

保存後、以下の項目を要約してください:

  • いくつの画面といくつの遷移があるか
  • デザイントークンパネルのどのセクションを設定したか
  • 仕様に記載がなかったため、iOS の慣例から推測または補完したもの
  • スキップした、または確信が持てなかったもの

これにより、ユーザーはレビューのためのチェックリストと、反復したい場合の明確な引き継ぎ情報を得られます。

ビジュアルスタイルのルール

これらは Apple のヒューマンインターフェースガイドラインに基づいています。デザインは、一般的な Web ではなく、疑いようのない iOS のように見える必要があります。

  • デバイスフレーム: iPhone 14 Pro / 15 Pro の比率 — 393 × 852 pt、47.33pt のコーナー半径
  • 常に描画するもの: Dynamic Island(中央揃えの楕円形、約 125 × 37 pt)、ステータスバー(時刻、信号、WiFi、バッテリー)、ホームインジケーター(下部)
  • デフォルトはライトモード: 仕様がダークモードを要求しない限り、ライトモードを使用する
  • フォント: システムフォントスタックを使用 -apple-system, BlinkMacSystemFont, "SF Pro Text", "SF Pro Display", system-ui, sans-serif
  • 標準の iOS クローム:
    • NavBar: 44pt の高さ、ラージタイトルスタイル(34pt 太字)またはインラインタイトル(17pt セミボールド)
    • TabBar: 49pt の高さ + セーフエリア
    • リスト行: 最低 44pt の高さ、セパレータのインセットは左から 16pt
    • タッチターゲット: 44 × 44 pt より小さくしない
  • 色: セマンティックシステムカラー(label、secondaryLabel、systemBackground、systemGroupedBackground、separator、tintColor)を使用します。references/design-tokens.md を参照してください。
  • アイコン: 一般的な SF Symbols にはインライン SVG パスを使用します(references/sf-symbols.md 参照)。一般的でないシンボルについては、シンボル名をテキストとしたプレースホルダーボックスを残します。例: [icon: フィギュア.ラン.サークル]。

キャンバスのレイアウト

HTML には3つの領域があります:

  1. ヘッダーストリップ(上部): アプリ名、バージョン(仕様にない場合はプレースホルダー)、生成日、および矢印の種類の凡例(実線 = プッシュ、破線 = モーダル表示、両矢印 = タブ切り替え)。
  2. 画面領域(メイン、水平スクロール可能): すべての iPhone フレームがフロー順に配置されます。関連するフローは視覚的にグループ化します(フローごとに垂直列、フロー内で水平方向に進行)。各フレームの下にラベル: S01 — ようこそ など。
  3. デザイントークンパネル(キャンバスの幅に応じて右側または下部): 色、タイポグラフィ、スペーシング、半径、シャドウ、コンポーネント。

矢印は、キャンバス全体をカバーする 1 つの絶対配置された SVG に描画され、pointer-events: none が設定されているため、スクロールを妨げません。各矢印は、marker-end の三角形を持つ <path> です。矢印ラベルは、パスに沿って配置された <text> 要素です。

デザイントークンパネル — 必ず含めるもの

トークンパネルは、このスキルを「いくつかの画面を描く」だけのものと差別化するものです。徹底的に行ってください:

  • 色: 画面で使用されるすべてのセマンティックカラーを、スウォッチ + 16 進数 + SwiftUI 名で表示します。ラベル / 塗りつぶし / 背景 / システム / カスタム(仕様がブランドカラーを指定している場合)でグループ化します。
  • タイポグラフィ: 使用されているすべてのテキストスタイル — Large Title、Title 1/2/3、Headline、Body、Callout、Subheadline、Footnote、Caption 1/2 — サイズ、ウェイト、行の高さとともに表示します。各スタイルをサンプル行としてレンダリングします。
  • スペーシングスケール: 4, 8, 12, 16, 20, 24, 32, 44, 64。視覚的なバーまたはボックスとして表示します。
  • コーナー半径: 4, 8, 12, 16, 22、連続。丸い正方形として表示します。
  • シャドウ / エレベーション: サンプル付きの 1〜3 レベル。
  • コンポーネント: いずれかの画面に表示されるすべてのコンポーネント — ボタン(プライマリ、セカンダリ、ターシャリ、デストラクティブ)、テキストフィールド(デフォルト、フォーカス、エラー)、リスト行、TabBar アイテム(アクティブ、非アクティブ)、NavBar(ラージ、インライン)、カード、トースト、アラート、アクションシート、セグメントコントロール、スイッチ、ステッパー、検索バー。それぞれについて、視覚的なサンプル + 主要なディメンション(パディング、高さ)+ 状態を表示します。

コンポーネントがいずれの画面にも表示されない場合は、パネルに含めないでください。実際に使用されているものだけを文書化します。

技術的な制約

  • フレームワークは使用しない: React、Tailwind CDN、外部 JS ライブラリは使用しません。純粋な HTML + インライン CSS + インライン SVG。
  • 外部フォントファイルは使用しない: 上記のシステムフォントスタックに依存します。
  • 単一ファイル: すべてがインラインです。ユーザーは .html をメールで送信でき、それが機能する必要があります。
  • 印刷対応: キャンバスを A3 横の PDF に破綻なく印刷できるように、@media print スタイルを含めます。矢印 SVG は正しくスケーリングする必要があります。
  • クロスブラウザ: 最低限、Safari と Chrome で動作する必要があります。

反復時のエチケット

ユーザーが最初のバージョン後に変更を求めた場合:

  • 局所的な変更が推奨されます。ユーザーが「S03 の TabBar をフローティングに変更して」と言った場合は、S03 のみを変更し、他のすべてはそのままにします。ファイル全体を再生成しないでください。
  • ファイル全体を書き換えるのではなく、ターゲットを絞った編集(str_replace または同等のもの)を使用します。
  • 構造的な変更の前には確認します。ユーザーが「ダークモードバージョンを追加して」と言った場合、ファイルサイズは 2 倍になります。最初に範囲を確認してください。

このスキルが NOT であるもの

混乱を避けるため:

  • 動作するプロトタイプではありません — ボタンは何もしません。レイアウト以上の JavaScript の相互作用はありません。矢印は視覚的なものであり、リンクではありません。
  • Figma ファイルではありません — Figma の .fig 形式はクローズドです。ユーザーが編集可能な Figma を希望する場合は、Figma Make / Builder.io を紹介するか、デザイナーが画像としてインポートできる SVG エクスポートを提供します。
  • プロダクションコードではありません — フレームはピクセルモックアップであり、SwiftUI ビューではありません。(ユーザーが SwiftUI を希望する場合、それは別のタスクです。)
  • レスポンシブ Web ではありません — キャンバスはデスクトップでの表示と PDF 印刷用にサイズ設定されています。.html ファイルのモバイル表示は許容範囲ですが、優先事項ではありません。

参考文献

必要に応じてこれらのファイルを読んでください:

  • references/html-structure.md — 実際の HTML スケルトン、CSS 変数、コピー&ペースト可能なコードを含む SVG 矢印テクニック
  • references/design-tokens.md — すぐに使用できる Apple HIG トークン値(色、タイポグラフィ、スペーシング)
  • references/sf-symbols.md — 最も一般的な 20 の SF Symbols のインライン SVG スニペット

最初の画面を描画する前に html-structure.md を読んでください。他の 2 つは必要に応じて読んでください。

関連スキル