justinwetch/HIGAgentSkills

概要

apple-hig は、会話型 AI エージェント向けの スキル（プラグイン）で、エージェントが Apple のヒューマンインターフェースガイドライン（HIG）に関する質問に回答できるようにします。リポジトリには、厳選されたソースレビュー済みの 157 件の HIG リファレンス（約 26.2 万語から約 9 万語に削減）と、既存のアプリを新しい折りたたみ式 iPhone Duo（iOS 27）に適応させるための特別な /duo スラッシュコマンドが含まれています。このスキルには機械学習モデルは含まれておらず、厳選されたテキストと、ホストエージェントが呼び出せる決定的なワークフローを提供するだけです。

主な機能

機能	説明
HIG リファレンスコーパス	157 のトピックファイル（`references/hig/*.md`）には、Apple の公式ガイドラインの正確な表現、値、条件が含まれており、忠実性を保ちながら大幅に短く書き直されています。
/duo コマンド	多段階ワークフロー（`commands/duo.md`）：1️⃣ アプリの画面をコードで評価し、2️⃣ Apple の Duo ガイダンスにマッチングし、3️⃣ SwiftUI プレビュー付きのオプションを提示し、4️⃣ 必要な SwiftUI/UIKit の変更を生成し、5️⃣ iPhone Duo シミュレータで検証します。
強制モード（オプション）	要求された場合、スキルは 2 人の独立したレビュー担当者が UI をスコアリングする「レビューと修復」ループを実行できます（90/100 の合格が必要）。最大 3 サイクル繰り返し、ホストが必要なサブエージェントとアーティファクトアクセスを提供すれば、問題を自動的に修正します。
ルーティングヘルパー	小さな Python スクリプト（`scripts/hig_route.py`）で、リテラルマッチに基づいてユーザーリクエストを適切なリファレンスファイルにマッピングし、トークン負荷を低く保ちます。
パッケージング	決定的な ZIP ビルダー（`scripts/package_runtime_zip.py`）が、必要なファイルのみ（`SKILL.md`、`routing-index.md`、`references/`、`commands/`）を含むランタイムバンドルを作成します。

インストール方法

コピーペーストプロンプト – 提供されたテキストブロックを AI エージェントのチャットに貼り付けます。エージェントはリポジトリをクローンし、apple-hig/ フォルダをスキルディレクトリに配置し、/duo コマンドを登録します。
手動インストール – ZIP をダウンロードし、apple-hig/ フォルダ全体をエージェントのスキル場所に解凍し、SKILL.md と commands/ フォルダが存在することを確認します。
スラッシュコマンド登録 – 一部のエージェントは commands/duo.md を自動検出しますが、他のエージェントではそのファイルをエージェントのカスタムスラッシュコマンドディレクトリにコピーし、ホストを再起動する必要があります。
検証 – エージェントにスキルを特定させ、バージョン（2026-09-27）と /duo が利用可能かどうかを報告させます。

典型的な使用法

apple-hig を使用して、この iOS アプリのナビゲーションとアクセシビリティをレビューします。

エージェントは関連する基本ファイル、プラットフォーム固有の HIG セクション、および 1 ホップ関連のガイダンスをロードし、ソース条項からの直接引用と簡潔な推奨事項で回答します。

Duo ワークフロー例

/duo ライブラリと読書フロー

コマンドは開発者を次のように導きます：

評価 – アプリの SwiftUI/Storyboard ファイルをスキャンします。
マッチング – 各画面を Duo チェックリストと比較します。
決定 – SwiftUI プレビューオプションを表示し、確認を求めます。
ビルド – 必要なコード変更を記述します。
検証 – iPhone Duo シミュレータでアプリを実行します（利用可能な場合）。プロジェクトに duo-notes.md ファイルが保持され、後で /duo continue が中断したところから再開できます。

強制モード例

apple-hig を強制モードで使用して、このインターフェースをレビューして修正します。

スキルは 2 つのレビューサブエージェントを生成し、UI をスコアリングし、修正を適用し、合格しきい値に達するか 3 サイクルが終了するまで繰り返します。

技術要件

Python 3.10+ – ルーティングヘルパーと強制モードのスコアリングに必要です。
特別なハードウェアは不要で、プレーンテキストの Markdown ファイルを読み取れる任意のホストで動作します。
エージェントはカスタムスラッシュコマンドをサポートするか、スキルディレクトリからファイルをロードできる必要があります。

ライセンスと帰属

コードと厳選されたリファレンスファイルは MIT ライセンス の下でリリースされています。
基盤となる Apple HIG 素材は Apple の所有物であり、リポジトリにはプロジェクトが Apple と提携していないことを明確にする NOTICE ファイルが含まれています。

この要約はリポジトリの README のみに基づいています。追加の機能は推測されていません。