1仕組みと動作原理

コアは同梱ディレクトリ内のローカルBM25検索エンジン：純粋なPython標準ライブラリ実装、外部依存関係ゼロ、ランタイムネットワーク通信ゼロ。データファイルは __file__ による相対パス解決を採用し、スキルディレクトリ自体がナレッジベースとして機能するため、任意のプラグインルートにコピーするだけで動作可能。

.claude/skills/ui-ux-pro-max/scripts/core.py

import csv import difflib import re from pathlib import Path from math import log from collections import defaultdict

同一ファイル冒頭の「UI/UX Pro Max Core - BM25 search engine for UI/UX style guides」および「DATA_DIR = Path(__file__).parent.parent / "data"」に合致—検索層はモデルやネットワークから完全に切り離されている。

ヒット判定はBM25スコアと単語カバレッジの二重閾値に基づき、低信頼度時は能動的に棄却（弱いデータではなく空を返す）。SKILL.md側でも「0ヒット→1回再試行→依然として空なら組み込みデフォルトであることを明示」を強制し、捏造を二重に防止。

.claude/skills/ui-ux-pro-max/scripts/core.py

abstain = (top_score <= threshold["min_score"] or coverage < threshold["min_coverage"] or (threshold["min_margin"] > 0 and top_score - runner_up_score < threshold["min_margin"]))

ドメイン別閾値テーブル（ドメインごとのmin_score、landingドメインのmin_coverage 0.5）およびスタック閾値（min_score 3.6、min_coverage 1/3）は同ファイル208〜213行目で定義。

17の検索ドメインと22の技術スタックはCSV_CONFIGおよびスタックCSVによって宣言的に駆動（各ドメインでsearch_colsとoutput_colsを限定）。検索は指定されたCSVの限定列に対するスコアリングとして実行され、無関係なフィールドによるノイズを構造的に排除。

.claude/skills/ui-ux-pro-max/scripts/core.py

"style": { "file": "styles.csv",

data/stacks/ には実質22個のCSV（react/nextjs/vue/svelte/astro/swiftui/flutter/jetpack-compose/wpf/winui/uno/uwpなど）が存在し、SKILL.md Step 4の宣言と合致。

--design-system は単なる文字列結合ではなくオーケストレーションパイプライン：製品ドメインからカテゴリを特定 → ui-reasoning.csv の推論ルールを適用 → style/color/landing/typography に対して重み付け複数ドメイン検索を実行 → パターン/スタイル/パレット/フォント/効果/アンチパターンを一連のセットとして出力。

.claude/skills/ui-ux-pro-max/SKILL.md

This aggregates product/style/color/landing/typography matches, applies reasoning rules from `ui-reasoning.csv`, and returns pattern, style, colors, typography, effects, and anti-patterns to avoid.

search.py 側のエントリポイントは '--design-system' モード（-p プロジェクト名、-f ascii/markdown、--json、3つのノブ --variance/--motion/--density を含む）。1〜10の3つのノブはクエリを変更することなく出力を偏向（低＝中央揃え/ミニマル、高＝大胆/非対称など）。

意思決定ルールは実行コードではなく制限されたDSL：reasoning_contract.py は決定論的な解析と書き換えのみを行い、「データは決して実行しない」と明記。actionプレフィックスはホワイトリスト（constraint/style/pattern/mode）で検証され、データ汚染が発生しても最大でルールの不一致にとどまり、任意コード実行は生じない。

.claude/skills/ui-ux-pro-max/scripts/reasoning_contract.py

"""Return deterministic mutations and an audit trail; never execute data."""

ホワイトリストの証跡は同ファイル45〜47行目：ALLOWED_CONDITIONS / ACTION_PREFIXES = {"constraint", "style", "pattern", "mode"} / TOKEN_ACTION_PREFIXES。eval/exec/subprocess は一切不使用（全文grepでヒットなし）。

永続化には「Master + Overrides」モデルを採用し、保守的なディスク書き込みを徹底：--persist には --output-dir の同時指定が必須であり、safe_slug によるプロジェクト名無害化（[a-z0-9_-]、パストラバーサル防止）、temp + NamedTemporaryFile + os.link による原子的かつ排他的なデプロイを実施。既存の MASTER.md はデフォルトでスキップされ、--force のみ上書き可能（ユーザーの明示的な許可が必須）。

.claude/skills/ui-ux-pro-max/scripts/design_system.py

def safe_slug(name, fallback: str = "default") -> str:

同ファイル976〜989行目の NamedTemporaryFile 書き込み + 'os.link(temp_name, path)' 排他デプロイ、1037/1058行目の FileExistsError 分岐。SKILL.md にも「Never use `--force` without explicit user authorization」と明記。

ワークフロー規約において「推測の禁止」をクエリ規律として明文化：Step 1で実際のスタックを検出（package.json/pubspec.yaml/*.xcodeproj 等。検出不可時はユーザーに確認し、デフォルトスタックのハードコードを禁止）→ Step 2 デザインシステム → Step 3 オンデマンドドメイン検索 → Step 4 スタックガイドライン。クエリは単一の主意図 + 2〜5語 + 1つの制約で構成。

.claude/skills/ui-ux-pro-max/SKILL.md

If nothing is detectable and stack guidance matters, ask the user. **Never assume a stack**

0ヒット時の規律原文：「## If a search returns 0 results … Do not fabricate output.」。出力側文言も「No matches. This is not a match with an empty value」（search.py 内。エージェントが空結果をデータと誤認するのを防止）。

2コア機能

01包括的なデザインシステムの一括生成（--design-system：パターン/スタイル/パレット/フォント/効果/アンチパターン + 推論ルール）

0212以上のドメインに対する絞り込み検索（style/color/product/ux/typography/google-fonts/icons/gsap/chart/landing/react/web…）、ドメイン自動判別および誤ルーティングを防ぐ明示指定に対応

0322の技術スタック向け実装ガイドライン（stacks/*.csv 計1,260行、deprecated/active のゲーティングを含む）、スタック検出を先行させデフォルトスタックの仮定を禁止

04アクセシビリティ/UXルールライブラリ（WCAGを含む119件）、「セマンティクス結果優先」のクエリパターンを採用（コンポーネント/スタックより先に ux ドメインを照会）

05GSAPアニメーションプリセット + クエリを変更せずに出力を調整する3つの1〜10デザインノブ（variance/motion/density）

06デザインシステムのセッション間永続化（design-system/<slug>/MASTER.md + pages/<page>.md、既存の決定事項はデフォルトで上書きしない）

07フォント/アイコン/チャートカタログ：1,934件のGoogle Fonts（ライセンススナップショット付き）、105件の厳選アイコン、25種のチャートタイプ、17種のGSAPプリセット

08ネイティブ/モバイル向け事前納品仕様および標準Pre-Delivery Checklist（references/pro-rules.md）

3外部依存関係

Kind	Dependency / Endpoint
network	运行时零外联（search.py/core.py/design_system.py/reasoning_contract.py 均无网络模块——import 审计全标准库）
network	维护期（仓库 CI refresh-catalogs.yml，非 skill 运行时、不随 skill 分发）：Google Fonts Developer API 快照
network	维护期：官方 google/fonts 仓库许可证元数据 sparse clone
package	维护期：npm 安装 pin 版 @phosphor-icons/core 与 @phosphor-icons/react（--ignore-scripts）导出图标清单

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

段階的・都度認可、サンドボックス推奨

管理者向け

承認フロー、ロールバック可能、全履歴監査

判定根拠（ファイルパスと抜粋）

scripts/: ローカルスクリプトまたはコマンドの実行: python3 scripts/search.py —— SKILL.md の指示に基づきエージェントが手動で呼び出し（単一CLI呼び出し: --domain/--de
本地工作目录: ファイル読み書きおよび成果物出力: --persist + --output-dir が明示的に指定された場合のみ、design-system/<project-slug>/MASTER.md および関連パスへ書き込み

監査ノート： 接触面 = ローカル標準ライブラリスクリプトの実行 + ローカルデータの読み書き：検索スクリプト（純粋な標準ライブラリ、外部依存なし、ランタイム通信なし）はエージェントが必要に応じて呼び出す設計。ディスク書き込みは --persist + --output-dir の明示的トリガー時のみ実行され、パストラバーサル防止、原子的処理、デフォルト非上書きの三重の保護を備える。認証情報の読み込み、自動実行チェーン、隠蔽スクリプトは存在しない（全ディレクトリの5つの実行/保守pyファイルは可読な標準ライブラリコード）。残余リスクはコード実行ではなく、出力内容の採用やデータサプライチェーンに起因するものに限定される。

5二重目の独立検証

[ok] 运行时零网络 — search.py 头 import（argparse/json/sys/io + 本地三模块）与 core/design_system/reasoning_contract 的 import 全为标准库；scripts/ 全树 grep requests/urllib/socket/http/curl/wget 零命中（tests 内 URL 为数据校验用字面量）。
[ok] 功能声明数字 vs 实际数据行数 — 行级计数：styles 88（50 active+29 supplemental+9 deprecated=可检索 79）、products/ui-reasoning/colors 192、typography 74、google-fonts 1934、ux-guidelines 119、icons 105、motion 17、charts 25、landing 34、stacks 22 文件 1260 行——与 description 及 catalog-summary.json 完全一致，无夸大。
[ok] 持久化写盘面（防穿越/原子/不覆盖） — design_system.py 精读：safe_slug 只留 [a-z0-9_-]、NamedTemporaryFile 写入 + os.link 排他发布、FileExistsError 默认跳过、--force 分支才覆盖；与 SKILL.md 'skips writing and leaves it untouched unless you also pass --force' 一致。
[ok] 决策规则无执行面 — reasoning_contract.py 无 eval/exec/subprocess/动态 import；ALLOWED_CONDITIONS/ACTION_PREFIXES/TOKEN_RE 白名单 + ValueError；docstring 'never execute data.'。
[ok] 凭证/env 读取 — 运行时唯一 env 读取 = design_system.py:615 COLORTERM；无 keychain/.env/密钥文件访问；CI 工作流使用的 GOOGLE_FONTS_API_KEY 为 GitHub secrets（仓库侧，非本机）。
[ok] 外部依赖真实性 — 3 条『维护期』条目逐一在 .github/workflows/refresh-catalogs.yml 65/91/121-123 行找到真实调用点；运行时外部依赖为空。
[ok] stars/活跃度/commit — GitHub API：stars 126346、pushed_at 2026-09-06T11:29:23Z、MIT；本地 git HEAD == pin 4aad0584d92131626b16d4ff4d77f0455385013c（2026-09-06 18:29:23 +0700）。
[ok] 分级校准（六档范式） — 运行自带 stdlib 本地脚本 + 显式触发本地写、无网络外发、无凭证 → blue（旧文件曾记 green，按 2026-09-09 统一分档准则校准为 blue）；reason 已重写。

6結論

検証可能で信頼性の高いデータ規模：公称値である88スタイル、192プロダクトプロファイル、1,934フォント、119のUXルール等はすべて行単位で整合性を確認済み。catalog-summary の sha256 スナップショットと provenance/freshness ガバナンスを完備。

徹底された対ハルシネーション設計：BM25とカバレッジの二重閾値による棄却、0ヒット時の偽装を禁じるツールメッセージ、SKILLによる「1回再試行、不可ならフォールバックの明示」の強制。

完全ローカル動作と極小のサプライチェーンリスク：ランタイムでのネットワーク通信やAPIキーは不要、標準ライブラリのみで構成。インストールはテキストデータとスクリプトのみで完結し、上書き防止・トラバーサル対策・原子的デプロイによる安全なディスク書き込みを実現。

Master + Overrides 永続化モデルにより、デザインシステムをセッションを跨いで再利用可能なプロジェクト資産へ変換。検索・生成・保存・再利用のクローズドループを確立。

広範なカバー率と高い実効性：22のスタック（希少なデスクトップ/ネイティブスタックを含む）× 各スタックに Severity/Docs URL/Status/Verified At 列を配備し、推奨事項を公式ドキュメントURLまで追跡可能。

最適な用途： Web、モバイル、デスクトップのUIデザイン、レビュー、リファクタリングを伴うAIコーディング環境（Claude Codeを含む19プラットフォーム）；スタイルからパレット、フォント、実装コードまでの一貫した推奨と複数フレームワークの指引を必要とするフロントエンド開発；オフラインや社内ネットワーク環境；リアルタイム検索よりも検証可能なローカルナレッジベースを重視するチーム。

不向きな用途： 最新フレームワークの仕様や最新コンポーネントAPIを必要とする用途（スナップショットのため最新情報と差がある場合があり、別途オンライン確認を推奨）；画像やビジュアルアセット自体の生成；純粋なバックエンドや非視覚的ロジックタスク（スキル定義上スキップ対象）；ヒューリスティックな美観提案を「公的認証」とみなすチーム；人手によるレビューを完全に排除した自動化パイプライン（0ヒット時の明示的ハンドリングが仕様上求められるため）。

Install Agent-Ready

① Verified Mirror 2026-09-09

Option A · Direct DownloadDownload ui-ux-pro-max.tar.gz

sha256: 7d01e476eb54034d…

Option B · Copy Guide for Agent

install.json

Agent はこの JSON ガイドから自動的にダウンロードして検証します。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit 4aad0584d9.