mcpField
I
ios-storyboard

ios-storyboard

github.com/pproenca開発218267 回インストール11 週間前に更新
リポジトリ

ios-storyboard について

ios-storyboardは、既存のクリニックプロジェクトでStoryboardベースのiOS画面を保守するためのスキルです。新しいSwiftUI機能向けではなく、Interface Builderでのレイアウト、ナビゲーション、適応性、アクセシビリティ、共同作業を扱います。

主な機能

  1. 01Storyboardシーンの構成
  2. 02Auto Layout制約の指針
  3. 03Segueとナビゲーションのパターン
  4. 04サイズクラスに応じたレイアウト
  5. 05アクセシビリティとVoiceOverの規則
  6. 06Storyboardのレビューとデバッグ

活用シーン

  1. 01Interface Builderでのシーン変更
  2. 02適応レイアウトと制約のレビュー
  3. 03Storyboard差分やマージ競合の解決

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pproenca/dot-skills --skill ios-storyboard

インストール後、Claude Code で/ios-storyboardを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

metadata.json
assets/templates/
_template.md
references/
_sections.md
adapt-dynamic-type.md
adapt-readable-content-guide.md
adapt-safe-area-all-devices.md
adapt-size-classes.md
adapt-trait-variations.md
ally-dynamic-labels.md
ally-grouping.md
ally-identifiers.md
ally-labels.md
ally-traits.md
arch-avoid-hardcoded-identifiers.md
arch-initial-view-controller.md
arch-modular-xibs.md
arch-one-scene-per-flow.md
arch-scene-naming.md
arch-split-storyboards.md
arch-storyboard-references.md
debug-ambiguous-layout.md
debug-constraint-identifier.md
debug-stale-outlets.md
debug-view-hierarchy.md
layout-avoid-constant-offsets.md
layout-avoid-fixed-dimensions.md
layout-constraint-nearest-neighbor.md
layout-constraint-priorities.md
layout-content-hugging.md
layout-inequality-constraints.md

詳細

iOS Storyboard のベストプラクティス

クリニックのプロジェクトに現在も残っている、Storyboard を多用したコードのためのレガシー相互運用ガイダンスです。新しい SwiftUI のクリニック機能開発向けではありません。

Xcode Storyboard と Interface Builder を対象に、保守性、適応性、アクセシビリティに優れた iOS インターフェースの構築に焦点を当てた、包括的な UI デザインおよびアーキテクチャガイドです。8 つのカテゴリにわたる 45 のルールを含み、自動リファクタリングとコード生成の指針となるよう、影響度の高い順に優先順位を付けています。

クリニックのアーキテクチャ契約（iOS 26 / Swift 6.2）

このスキルのすべてのガイダンスは、クリニックのモジュール型 MVVM-C アーキテクチャを前提としています。

  • 機能モジュールがインポートするのは Domain と DesignSystem のみです（Data や兄弟機能はインポートしません）
  • App ターゲットが集約点となり、DependencyContainer、具象コーディネーター、Route Shell の配線を所有します
  • Domain は純粋な Swift を保ち、モデルに加え、リポジトリ、*Coordinating、ErrorRouting、AppError の各契約を定義します
  • Data は SwiftData／ネットワーク／同期／再試行／バックグラウンド I/O を所有し、Domain のプロトコルを実装します
  • 読み取り／書き込みフローのデフォルトは、stale-while-revalidate 方式の読み取りと、楽観的なキューイング書き込みです
  • ViewModel はリポジトリのプロトコルを直接呼び出します（デフォルトのユースケース／インタラクター層はありません）

適用する場面

以下の場合に、これらのガイドラインを参照してください。

  • Xcode Interface Builder で Storyboard のシーンを作成または変更する
  • 適応型レイアウト用に Auto Layout の制約を設定する
  • segue と storyboard reference を使ってナビゲーションフローを設計する
  • ユニバーサルアプリ向けにサイズクラスと trait のバリエーションを設定する
  • Storyboard の XML 差分をレビューし、マージの競合を解決する

優先度別のルールカテゴリ

優先度カテゴリ影響度プレフィックス
1Storyboard アーキテクチャCRITICALarch-
2Auto Layout 制約CRITICALlayout-
3ナビゲーションと segueHIGHnav-
4適応型レイアウトとサイズクラスHIGHadapt-
5ビュー階層と Stack ViewMEDIUM-HIGHview-
6アクセシビリティと VoiceOverMEDIUMally-
7バージョン管理とコラボレーションMEDIUMvcs-
8デバッグとインスペクションLOW-MEDIUMdebug-

クイックリファレンス

1. Storyboard アーキテクチャ（CRITICAL）
2. 自動レイアウトの制約（重大）
3. ナビゲーションとセグエ（高）
4. アダプティブレイアウトとサイズクラス（高）
5. ビュー階層とスタックビュー（中〜高）
6. アクセシビリティとVoiceOver（中）
  • ally-labels - すべてのインタラクティブ要素にアクセシビリティラベルを設定する
  • ally-traits - Interface Builderで適切なアクセシビリティ特性を割り当てる
  • ally-grouping - VoiceOverのナビゲーション向けに関連する要素をグループ化する
  • ally-identifiers - UIテスト用のアクセシビリティ識別子を設定する
  • ally-dynamic-labels - 動的コンテンツに合わせてアクセシビリティラベルを更新する
7. バージョン管理とコラボレーション（中）
8. デバッグと検査（低〜中）

使用方法

詳しい説明やコード例については、各リファレンスファイルをお読みください。

リファレンスファイル

ファイル説明
references/_sections.mdカテゴリーの定義と順序
assets/templates/_template.md新しいルール用のテンプレート
metadata.jsonバージョンとリファレンス情報

コメント

Markdown 対応