mcpField
H
hig-project-context

hig-project-context

github.com/raintree-technologyデザイン・UI148643 回インストール6 日前に更新
リポジトリ

hig-project-context について

hig-project-contextは、プロジェクト固有のAppleデザインコンテキスト文書を作成・管理するスキルです。プロジェクトのファイルやコードから情報を見つけ、確認済みの内容を関連するHIGスキルで活用して、質問の重複を避けます。

主な機能

  1. 01プロジェクトファイルやコードから情報を抽出
  2. 02製品とプラットフォームの情報を収集
  3. 03技術スタックとデザインシステムを記録
  4. 04アクセシビリティとユーザー要件を整理
  5. 05変更箇所のみを文書に反映

活用シーン

  1. 01Apple HIGの指針に向けてプロジェクト情報を準備
  2. 02設計タスク間で確認済みのアプリ情報を再利用
  3. 03プロジェクト変更後にコンテキストを更新

インストール

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

$npx skills add https://github.com/raintree-technology/hig-doctor --skill hig-project-context

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

詳細

Apple HIG：プロジェクトのコンテキスト

.claude/apple-design-context.md を作成して管理し、ほかの HIG スキルが重複した質問を省けるようにします。

質問する前に .claude/apple-design-context.md を確認してください。既存のコンテキストを利用し、すでに記載されていない情報だけを質問します。

コンテキストの収集

質問する前に、次の情報を自動的に確認します。

  1. README.md -- 製品の説明、対象プラットフォーム
  2. Package.swift / .xcodeproj -- 対応プラットフォーム、最小 OS バージョン、依存関係
  3. Info.plist -- アプリのカテゴリ、必要な機能、対応する画面の向き
  4. 既存のコード -- import 文からフレームワーク（SwiftUI と UIKit、HealthKit など）を確認します
  5. Assets.xcassets -- カラーアセット、アイコンセット、ダークモードのバリエーション
  6. アクセシビリティ監査 -- アクセシビリティ修飾子や属性を grep で検索します

調査結果を提示して、ユーザーに確認または修正してもらいます。その後、まだ不足している情報を収集します。

1. 製品の概要
  • アプリでは何ができますか？（1 文で）
  • カテゴリ（生産性、ソーシャル、ヘルス、ゲーム、ユーティリティなど）
  • 段階（コンセプト、開発中、リリース済み、再設計）
2. 対象プラットフォーム
  • 対象となる Apple プラットフォーム（iOS、iPadOS、macOS、tvOS、watchOS、visionOS）
  • 最小 OS バージョン
  • ユニバーサル対応か、プラットフォーム固有か
3. 技術スタック
  • UI フレームワーク：SwiftUI、UIKit、AppKit、または混在
  • アーキテクチャ：シングルウィンドウ、マルチウィンドウ、ドキュメントベース
  • 使用している Apple テクノロジー（HealthKit、CloudKit、ARKit など）
4. デザインシステム
  • システムのデフォルト設定か、カスタムデザインシステムか
  • ブランドカラー、フォント、アイコンのスタイル
  • ダークモードと Dynamic Type の対応状況
5. アクセシビリティ要件
  • 目標レベル（基本、強化、包括的）
  • 個別の配慮事項（VoiceOver、Switch Control など）
  • 規制要件（WCAG、Section 508）
6. ユーザーの状況
  • 主なペルソナ（1～3 人）
  • 主なユースケースと利用環境（デスク、外出先、一目で確認、没入型）
  • 把握している課題やデザイン上の難題
7. 既存のデザインアセット
  • Figma／Sketch ファイルはありますか？
  • Apple Design Resources を使用していますか？
  • 既存のコンポーネントライブラリはありますか？

コンテキストドキュメントのテンプレート

次の構成で .claude/apple-design-context.md を生成します。

# Apple Design Context

## Product
- **Name**: [App name]
- **Description**: [One sentence]
- **Category**: [Category]
- **Stage**: [Concept / Development / Shipped / Redesign]

## Platforms
| Platform | Supported | Min OS | Notes |
|----------|-----------|--------|-------|
| iOS      | Yes/No    |        |       |
| iPadOS   | Yes/No    |        |       |
| macOS    | Yes/No    |        |       |
| tvOS     | Yes/No    |        |       |
| watchOS  | Yes/No    |        |       |
| visionOS | Yes/No    |        |       |

## Technology
- **UI Framework**: [SwiftUI / UIKit / AppKit / Mixed]
- **Architecture**: [Single-window / Multi-window / Document-based]
- **Apple Technologies**: [List any: HealthKit, CloudKit, ARKit, etc.]

## Design System
- **Base**: [System defaults / Custom design system]
- **Brand Colors**: [List or reference]
- **Typography**: [System fonts / Custom fonts]
- **Dark Mode**: [Supported / Not yet / N/A]
- **Dynamic Type**: [Supported / Not yet / N/A]

## Accessibility
- **Target Level**: [Baseline / Enhanced / Comprehensive]
- **Key Considerations**: [List any specific needs]

## Users
- **Primary Persona**: [Description]
- **Key Use Cases**: [List]
- **Known Challenges**: [List]

コンテキストの更新

既存のコンテキストドキュメントを更新する場合：

  1. 現在の .claude/apple-design-context.md を読みます
  2. 何が変更されたかを尋ねます
  3. 変更されたセクションだけを更新します
  4. 変更のない情報はすべて保持します

関連スキル

  • hig-platforms -- プラットフォーム固有のガイダンス
  • hig-foundations -- 色、タイポグラフィ、レイアウトの決定
  • hig-patterns -- UX パターンの推奨事項
  • hig-components-* -- コンポーネントの推奨事項
  • hig-inputs -- 入力方法の対応
  • hig-technologies -- Apple テクノロジーとの関連性

制作：Raintree Technology · その他の開発者向けツール

コメント

Markdown 対応