ios-hig-design-guide

iOS HIG デザインガイド

Apple の公式ガイダンスに沿った iOS デザインの推奨事項を作成する際に、このスキルを使用します。

クイックスタート

1. 公式ソースを同期します。
2. 関連するセクションだけを読みます。
3. 機能に特化した仕様を作成します（一般的なスタイルの羅列にはしません）。

実行します：

python3 scripts/sync_apple_hig_sources.py --skill-dir .

信頼できる情報源

• リンクと概要を含む全件の未加工インデックス：references/apple-hig-ios-raw.md
• ダウンロードした全ページの統合テキストダンプ：references/apple-hig-ios-fulltext.md
• iOS 仕様作成用に厳選されたテキストダンプ：references/apple-hig-ios-curated.md
• 関連する HIG ページの選び方を示すワークフロー：references/ios-design-spec-workflow.md
• ページごとの JSON ソース：references/raw/pages/design/human-interface-guidelines/*.json
• クロールのメタデータと取得状況：references/raw/catalog.json

ワークフロー

1) 同期して確認する

• 「最新」または「現在」の内容を尋ねられた場合は、回答前に同期スクリプトを実行します。
• references/raw/catalog.json で download_error が 0 であることを確認します。
• エラーがある場合は、失敗したパスを報告し、正常にダウンロードできたページを使って作業を続けます。

2) 範囲を絞り込む

• /design/human-interface-guidelines/designing-for-ios から始めます。
• リクエストされた機能に直接関係するセクションだけを追加します。
• 基本的な制約（アクセシビリティ、レイアウト、タイポグラフィ、色、文章表現、プライバシー）を優先します。
• 日常的な利用には references/apple-hig-ios-curated.md を優先し、必要な場合にのみ全件ダンプを使用します。

3) 制約を抽出する

選択した各ページから、実装可能な具体的ルールを抽出します。

• コンポーネント／パターンを使用する場面
• 必要な状態（読み込み中、空、エラー、破壊的操作の確認）
• アクセシビリティの動作（ラベル、ヒント、タッチ領域、ダイナミックタイプ）
• ローカライズ／レイアウトの動作（RTL、切り捨て、複数行表示）
• プラットフォーム固有の注意点（iOS 専用か、クロスプラットフォームか）

4) 成果物を作成する

出力の標準構成：

1. 機能の目標とユーザーシナリオ
2. 情報アーキテクチャと画面一覧
3. インタラクションと状態モデル
4. コンポーネント仕様
5. アクセシビリティとローカライズのチェックリスト
6. 未解決の質問とトレードオフ

出力スタイルのルール

• 主要なルールごとに、ソースページのパスを記載します。
• HIG のガイダンスを、実行可能なプロダクト上の判断に落とし込みます。
• 未加工の文章を大量にコピーすることは避けます。
• 推論に基づく推奨事項は、推論であることを明示します。

メンテナンス

• Apple が HIG の内容を更新したら、同期スクリプトを再実行します。
• 生成された未加工ファイルは references/ に保持し、生成物を手動で編集しないでください。
• この SKILL.md は、ワークフローまたは品質の改善に限って更新します。