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 分数 + 词覆盖度双阈值，低置信时主动 abstain（返回空而非弱数据）；SKILL.md 同侧强制『0 命中→重试一次→仍空则明示来自内置默认』，双保险防编造。

.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 做加权多域检索 → 产出成套 pattern/风格/色板/字体/效果/反模式。

.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、三旋钮 --variance/--motion/--density）；三个 1-10 旋钮在不改 query 前提下偏置输出（低=居中/极简，高=大胆/非对称等）。

决策规则是受限 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.'

工作流契约把『禁猜』写成查询纪律：Step1 探测真实栈（package.json/pubspec.yaml/*.xcodeproj 等，探测不到就问，禁止硬编码默认栈）→ Step2 设计系统 → Step3 按需域检索 → Step4 栈指引；query 单一主导意图 + 2-5 词 + 一个约束。

.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，防 agent 把空结果当数据）。

2核心能力

01一键生成成套设计系统（--design-system：pattern/风格/色板/字体/效果/反模式 + 推理规则）

0212+ 域定向检索（style/color/product/ux/typography/google-fonts/icons/gsap/chart/landing/react/web…），域可自动检测但可显式指定防误路由

0322 个技术栈实现指引（stacks/*.csv 共 1260 行，含 deprecated/active 门控），先探测栈再检索、禁默认栈

04无障碍/UX 规则库（119 条，含 WCAG），按『语义结果优先』查询法（先 ux 域结果再组件域/栈）

05GSAP 动画预设 + 三个 1-10 设计旋钮（variance/motion/density）不改 query 偏置输出

06设计系统跨会话持久化（design-system/<slug>/MASTER.md + pages/<page>.md，默认不覆盖已有决策）

07字体/图标/图表目录：1934 个 Google Fonts（含许可快照）、105 条精选图标、25 图表类型、17 GSAP 预设

08native/mobile 交付前规范与 canonical 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 —— 由 agent 按 SKILL.md 指示手动调用（单次 CLI：--domain/--de
本地工作目录: 文件读写与工件输出: 仅 --persist + --output-dir 显式触发时写 design-system/<project-slug>/MASTER.md 与

审计说明： 。接触面=本地标准库脚本执行 + 本地数据读写：检索脚本（纯 stdlib、零第三方、零运行时网络）由 agent 按需调用；写盘仅 --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 产品档案/1934 字体/119 UX 规则等全部行级复核一致，且带 catalog-summary sha256 快照与 provenance/freshness 治理。

反幻觉设计少见地工程化：BM25+覆盖度双阈值 abstain、0 命中工具文案直接禁止伪装、SKILL 强制『重试一次否则显式标注 fallback』。

纯本地、供应链面小：运行时零网络零密钥、仅标准库，安装分发即文本数据+脚本；写盘默认不覆盖、防穿越、原子发布。

Master + Overrides 持久化模式把设计系统变成跨会话可检索的项目资产，检索→生成→落盘→复用闭环完整。

覆盖面与落地性强：22 栈（含少见桌面/native 栈）× 每栈带 Severity/Docs URL/Status/Verified At 列，建议可追溯到具体文档 URL。

适合： 适合 Web/mobile/桌面 UI 设计、评审、重构的 AI 编码场景（Claude Code 等 19 平台）；需要风格→色板→字体→落地代码成套推荐与多框架指引的前端开发；离线/内网环境；偏好可复核本地知识库而非联网检索的团队。

不适合： 需要实时框架文档/最新组件 API 的场景（快照知识滞后，建议另行联网核实）；视觉/图片生成；纯后端或非视觉逻辑任务（skill 自述 skip）；把启发式审美建议当作『权威认证』的团队；期望零人工复核的自动化管线（0 命中时设计上就要求 agent 显式处理）。

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.