hig-project-context

hig-project-context スキルの概要

hig-project-context は、共有の Apple デザインコンテキストファイルを作成または更新し、他の HIG スキルがより的確に、同じ質問を何度も繰り返さずに提案できるようにするスキルです。Apple アプリチーム、Claude ベースのコーディングワークフロー、そしてプロジェクトの範囲・対象プラットフォーム・デザイン上の制約を一元管理したいスキル作者に特に向いています。

主な役割はシンプルです。プロジェクトコンテキストを .claude/apple-design-context.md に一度まとめ、その後 hig-foundations、hig-platforms、hig-components-*、hig-inputs、hig-technologies などの下流 HIG スキルで再利用できるようにすることです。新しい Apple プラットフォーム案件を始めるときや、エージェントに不足情報だけをきれいに確認させたいときに役立ちます。

hig-project-context が実際に行うこと

hig-project-context は UI デザインを生成するスキルではなく、コンテキストを収集し、書き出すためのスキルです。README の内容、パッケージや Xcode のプラットフォーム設定、Info.plist、コード内で使われているフレームワーク、アセットカタログ、アクセシビリティの手がかりなどをリポジトリから拾い上げ、その結果をユーザーに確認または修正してもらいます。

なぜ導入されるのか

hig-project-context を入れると、やり取りの往復を減らしつつ、プロジェクト全体で一貫した Apple デザイン指針を得やすくなります。特に、HIG 関連の新しいタスクが始まるたびに、同じプラットフォーム・製品・技術について何度も答えるのに疲れている場合に効果的です。

向いているケースと向いていないケース

このスキルは、すでにコードやリポジトリのメタデータを確認できるプロジェクトに向いています。逆に、まだアイデア段階で実体がない場合や、Apple 製品ではない場合、あるいは再利用可能な共有コンテキストが不要な単発プロンプトでは、あまり価値がありません。

hig-project-context スキルの使い方

hig-project-context をインストールして有効化する

リポジトリのスキルインストール手順に従い、.claude/apple-design-context.md を作成または更新したいときに hig-project-context を呼び出します。実務上は、hig-project-context install の実行そのものよりも、Claude のワークフロー内でこのスキルが使える状態になっていて、正しいリポジトリルートを指していることのほうが重要です。

最初に適切な入力を与える

このスキルは、ざっくりしたプロジェクトの目的とリポジトリの場所が入っていると最もよく機能します。良い初期プロンプトは、発見作業の方向を示せる程度には具体的で、しかも不足しているコンテキストを隠してしまうほど詳細すぎないものです。

例:

• “Use hig-project-context to build a shared context file for this Apple app. It’s a health tracking app with SwiftUI and iPhone-first support.”
• “Run hig-project-context for this repo and tell me what platform and framework signals you find before writing the context file.”

出力を信じる前に確認すべきこと

まず SKILL.md を確認し、そのうえでスキルが読むように設計されたリポジトリ内のファイル、つまり README.md、Package.swift、.xcodeproj、Info.plist、そしてコードベースそのものを見ます。リポジトリの抜粋には補助フォルダが含まれていないため、このスキルは意図的に軽量です。価値があるのは大規模なルール群ではなく、発見のワークフローにあります。

よりきれいな結果につながるワークフロー

hig-project-context usage としてうまく機能する流れは次のとおりです。

1. スキルにリポジトリの根拠を集めさせる。
2. 見つかった製品・プラットフォーム・フレームワークの संकेतを確認する。
3. コンテキストを承認するか、修正する。
4. 結果を .claude/apple-design-context.md に保存する。
5. ほかの HIG スキルを使うときにそのファイルを再利用する。

この順番にすると、下流スキルがプラットフォームの範囲を推測してしまうことを防げます。Apple のガイダンスで起きるミスの多くは、まさにそこで発生します。

hig-project-context スキル FAQ

hig-project-context は新規プロジェクト専用ですか？

いいえ。共有の Apple デザインコンテキストファイルがまだない既存リポジトリや、時間とともに内容がずれてしまったリポジトリにも有効です。チームが同じセットアップ質問に何度も答えているなら、このスキルでそのコンテキストを標準化できます。

通常のプロンプトと何が違いますか？

通常のプロンプトは、プラットフォーム情報を一度だけ尋ねることがあります。hig-project-context は、プロジェクトコンテキストを発見・確認・保存するための再利用可能なワークフローであり、後続の HIG スキルがそれを前提に動けるようにします。

初心者でも Apple HIG の知識が必要ですか？

不要です。ただし、実際のリポジトリ、少なくとも具体的な対象プロジェクトは必要です。このスキルは、適切な発見質問をしてくれるという意味で初心者向けですが、足りない製品知識を埋めることはできません。

使わないほうがいいのはどんなときですか？

Apple のデザインガイダンスに紐づかない作業、確認できるリポジトリがない場合、あるいは共有コンテキストを作らず単発の答えだけが欲しい場合は、hig-project-context を使わないでください。

hig-project-context スキルを改善する方法

ソースとなるシグナルをもっと強くする

hig-project-context の精度は、検証できる情報の質に左右されます。リポジトリのルートを渡し、想定している Apple プラットフォームを明示し、SwiftUI、UIKit、HealthKit、ウィジェットなど、コードからは自明でないフレームワーク選択があればそれも伝えてください。

コンテキストは受け入れるだけでなく、必ず確認する

hig-project-context guide として最も役立つのは、無条件に自動化へ任せることではなく、確認して修正することです。スキルがターゲットプラットフォーム、デプロイ範囲、アプリカテゴリを誤って推定した場合は、その場で直してください。そうすれば、下流スキルにも正確なコンテキストが引き継がれます。

足りない判断材料を補う

最初の抽出が不十分なら、デザイン指針に特に効く情報を追加します。たとえば、製品の目的を一文で、対象デバイス、最低 OS バージョン、主要機能、アクセシビリティ上の制約などです。これらは、他の HIG スキルがどう応答すべきかを変える重要な要素です。

ファイルを再利用し、範囲が変わったら更新する

最大の失敗要因は、コンテキストが古くなることです。アプリに新しいプラットフォームが追加されたとき、UI フレームワークを切り替えたとき、中心となるユースケースが変わったときは、.claude/apple-design-context.md を更新してください。さもないと、hig-project-context for Skill Authoring が古い前提をその後の助言にまで持ち越してしまいます。