SuperAPI AI 工具集

stylekit

通用与其它

查看项目

更新于 10-15 16:51

技能介绍

StyleKit 用于给前端 UI 确定可辨识的视觉方向,适合新建界面、改样式或修复既有界面、比较与推荐组件库、检查一致性、获取素材或模板等任务。风格规范只作设计指导,不替代产品决策。

使用前需安装该 Skill,脚本要求 Python 3.10+。<skill-root> 是包含该文件的目录,不是目标项目的 scripts/ 目录;占位符需替换为真实路径并保持引号。任务产物应存放到新建的专用目录,不要复用其他任务的规范文件。若为固定 tag/commit 安装,首次检查前应禁用更新;否则运行: python3 "<skill-root>/scripts/update-skill.py" --auto 状态为 UPDATED 时需重新读取文件;其他状态继续按已安装说明执行,离线检查不阻断工作。更新最多每 24 小时跟随 GitHub main 一次,受管文件有本地改动或路径冲突时跳过整次更新。

处理任务时按类型区分:新建 UI 先选方向、加载规范并实现真实内容与状态;改样式保留行为、路由与数据,只改相关视觉决策;比较库时先确认平台并用官方来源比较候选,仅在要求时实现;评审时对照已保存规范报告具体问题;获取素材时按 assets 说明使用返回的 kind/id、可用性与许可。移动端界面、响应式交互或 ChunUI 等库需先读 mobile UI,并先确定 Web/H5、React Native/Expo、SwiftUI 或 Flutter;看起来像移动端的浏览器页面仍属 Web 实现。

选择风格时先检查目标应用并复用其已有基础组件。栈不明确时运行: python3 "<skill-root>/scripts/detect-project.py" "<project-root>" 检测结果只是证据,不代表兼容性保证;依赖是声明范围,版本或工作区边界重要时需查看 lockfile 与应用子目录,不要为匹配建议库而迁移框架。明确风格用其精确 slug;否则从用户上下文搜索并挑选合适方向,仅在未决选择会实质影响结果时提问;仅推荐库不需要获取风格规范。

获取规范示例: python3 "<skill-root>/scripts/fetch-style.py" --search "frosted glass" python3 "<skill-root>/scripts/fetch-style.py" "<slug>" --json > "<work-dir>/spec.json" 实现与评估应使用同一份已保存规范。_stylekitSource.degraded 表示旧数据可能缺少精选 lint 规则,需说明该限制。获取失败时可复用已识别的已保存规范,或说明当前目录无法验证,不得编造成功获取、slug 或规则。

实现时按需使用 philosophy、tokens、signature elements 与 recipes,保留用户的明确选择、既有交互与无障碍需求;recipes 只是起点。原生目标需把视觉意图转译为平台组件,DOM 标记与 Tailwind 类不是原生 API。新 UI 需包含加载、空、错误与成功状态。globalCss 需与既有层叠整合;Tailwind v4 中应让位给工具类的通用重置放到 @layer base 或有意限定作用域,未分层选择器可能覆盖工具类样式。

校验可对兼容的 Web 类规则使用: python3 "<skill-root>/scripts/eval-check.py" "<slug>" "<component-file>" --spec "<work-dir>/spec.json" --component button --strict 必需类是在整个输入文件中匹配,不是按元素匹配;整页严格通过不能证明每个控件都通过。缺失规则或动态类可能无法定论,需人工检查。该评估器不验证 SwiftUI、React Native、Flutter、素材或无障碍。还应运行目标项目相关检查、在合适尺寸渲染并测试变更状态,检查计算颜色与焦点行为而非仅类名;原生工作需区分源码审查、构建、模拟器与真机检查。实现与实际验证应分别报告,包括不可用的运行时。该技能不安装 MCP 包,也不修改客户端配置。