mcpField
U
ui-spec

ui-spec

github.com/idaibin设计与 UI636 次安装1 天前更新
代码仓库

关于 ui-spec

ui-spec 是一项路由技能，可根据有依据的需求简报或已接受的视觉来源生成可供实现的 UI 契约。它将 UI 就绪状态与产品审批、实现、运行时证据及交付决策区分开来。

主要功能

  1. 01将请求路由至适用的 UI 模块
  2. 02定义功能与共享设计契约
  3. 03按切片跟踪证据、缺口和就绪状态
  4. 04区分 UI 就绪与交付权限

适用场景

  1. 01为选定页面或流程编写规范
  2. 02探索尚未批准的视觉方向
  3. 03采用或更改共享视觉语义
  4. 04评估多个界面的就绪状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/idaibin/skills --skill ui-spec

安装后在 Claude Code 中输入/ui-spec确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
assets/
DESIGN.md
frontend-visual-evidence.schema.json
references/
candidate-visual-direction.md
design-md-contract.md
documentation-boundaries.md
eval-cases.md
evaluation-rubric.md
frontend-layout-governance.md
frontend-visual-evidence.md
measurement-normalization.md
multi-surface.md
scene-archetypes.md
svg-icon-system.md
usage.md
visual-direction-and-anti-slop.md
visual-source.md
workflow.md
scripts/
validate-design-md-completeness.py
validate-frontend-visual-evidence.py

详细介绍

UI 规范

用途

生成可直接用于实施的 UI 契约，同时不取代产品、共享设计、组件/源码、运行时证据或交付方面的权威。本文件是一张路由图： 选择分支后，只需阅读其引用的模块。

入口门槛

  • 必须提供以来源为依据的候选简报，或已选定/接受的视觉来源；否则停止并标记为 evidence-incomplete。
  • 在获准写入制品前，阅读有效的仓库指南并检查当前 Worktree 状态。
  • 将产品行为、Feature UI Markdown、已采用的 DESIGN.md、组件源码、运行时证据和 Git 交付视为彼此独立的权威。

路由图

请求状态加载结果
适用性或来源选择不明确用法 和 视觉来源明确范围/来源或停止
方向处于探索阶段且未经批准候选方向被忽略的本地候选规范及同步的完整生成提示词；DESIGN.md 不变；Not Ready
已选定页面、流程或接受的界面工作流 和 文档边界Feature Spec 和逐切片就绪状态
正在采用或更改共享视觉语义DESIGN.md 契约已批准并通过 lint 的 <design-root>/DESIGN.md；Feature Spec 引用它
涉及多个独立界面多界面共享索引及可独立加载的切片/判定

不变量

  • 候选交接需绑定候选规范/提示词修订版及其哈希。已接受契约的交接和证据需绑定已接受的比较基准修订版。
  • 不得臆造产品行为、精确值、资源、组件归属、权利、运行时事实或共享语义。对于未知项，使用已定义的证据级别标记。
  • 不得在 Feature Spec 中重复共享令牌或组件接口，不得引入平行 Registry/架构，也不得强制要求未更改的本地切片采用 DESIGN.md。
  • 结构化投影是有条件的：仅当已存在指定的所有者、生产方、非 LLM 消费方、语义版本、可执行验证器、漂移策略和退役规则时才使用。
  • 不得操作外部 AI、生成/编辑图像或 SVG 源码、编辑产品源码、操作浏览器/客户端状态或更改 Git。此类操作应交由其所有者处理。
  • Ready 仅表示 UI 视觉/交互就绪，不代表产品批准、实施、评审、运行时、交付、部署或生产环境证明。

输出图

返回 [email protected]，包含生命周期/配置文件、来源身份及权利、权威处置、切片 ID、适用的布局/状态/交互/无障碍和资源契约、差异/证据引用、比较基准、逐切片就绪状态及明确的差距。候选输出还需返回两个被忽略路径/哈希以及交接状态。将任务本地证据存储在经验证且被忽略的 .codex/artifacts/ 下。仅在启用相应模块时才包含 DESIGN、视口、SVG 或运行时证据字段。

参考索引

仅在适用条件满足时加载模块：

条件模块
视觉方向、主题、颜色、保留/改造选择视觉方向
已接受/候选来源指定了场景原型场景原型
布局归属、内嵌、覆盖、焦点、命中顺序或过渡发生变化布局与交互
需要对重复的源测量结果进行标准化测量标准化
验收内容包含 SVG/图标的作用或回退方案SVG 图标规范
将当前运行时与选定来源进行比较视觉证据
正在判定最终就绪状态评估标准

维护者在回归工作中使用 评估用例；日常 UI 规范制定时不要加载 这些用例。

评论

支持 Markdown