SuperAPI AI 工具集

ui-system-governance

设计与创作

查看项目

更新于 10-16 00:21

技能介绍

用途:当项目已有 UI 工作、设计系统需要文档化、维护或审计时使用。目标是让人类与智能体对现有系统保持一致:记录已有内容、所在位置、未来 UI 必须遵循的规则,以及需要纠正的不一致。

主要能力:定位现有设计文档(DESIGN.md、AGENTS.md、Storybook 文档、组件 README、Figma 交接说明或设计系统页面);盘点令牌(颜色、字体、间距、圆角、阴影、动效、断点、主题覆盖);盘点基础组件、复合组件、功能区块与布局外壳,记录源路径、变体、尺寸与用途;审计令牌漂移(内联十六进制、硬编码像素、任意 Tailwind 值、暗色模式不匹配、一次性样式);审计组件漂移(重复按钮/输入/卡片、变体爆炸、无行为包装器、功能组件放入基础目录);审计布局漂移(重复仪表盘外壳、最大宽度不一致、页头/侧栏尺寸不匹配、页面级间距);审计质量缺口(缺失加载/空/错误状态、焦点状态弱、响应式差、交互不可访问、缺少减少动效处理);生成或更新 DESIGN.md,含当前事实来源、未来新增规则与系统决策变更日志;按优先级提出修复建议,不静默重写设计系统。

输出格式:UI 系统治理报告,包含文档状态、系统成熟度、主要事实来源、令牌清单、组件清单表、布局外壳清单、漂移与一致性问题表(问题、严重度、证据、建议修复)、DESIGN.md 更新、优先修复项、面向未来智能体的护栏规则。

限制与边界:不适用于尚无 UI 的全新项目(应使用 $ui-system-initializer);不用于单个组件行为问题(应使用 $component-spec-writer)。不要将文档视为一次性设置文件;新增组件须先登记清单;不得用新抽象掩盖不一致;重命名或移除令牌/组件须说明迁移影响;不得让智能体无记录地创建视觉例外。最终前需验证:报告识别当前令牌、组件与布局事实来源;DESIGN.md 指导足够具体;漂移问题含证据与建议修复;优先修复区分紧急一致性问题与可选打磨;未来新增有明确复用、扩展或新增基础组件的护栏。