ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

如何用UI Skills构建团队级设计系统Agent工作流:企业落地方案

如何用UI Skills构建团队级设计系统Agent工作流:企业落地方案 如何用UI Skills构建团队级设计系统Agent工作流企业落地方案【免费下载链接】ui-skillsSkills for Design Engineers项目地址: https://gitcode.com/GitHub_Trending/ui/ui-skillsUI Skills是面向设计工程师Design Engineers的技能集项目它为 Codex、Cursor、Claude Code 等 AI 编程 Agent 提供一组可直接加载的「设计系统技能」帮助企业把 UI 规范、可访问性、动效性能等团队共识固化成 Agent 可执行的工作流让 AI 写出的界面不再千码一面。本文给出一套从零上手的团队级落地方案。一、为什么团队需要 UI SkillsAI 生成界面最大的痛点是风格漂移同一个产品里Agent 今天用渐变色、明天又手写键盘焦点逻辑团队设计系统形同虚设。UI Skills 的思路是把「团队规范」拆成一个个带明确边界的技能文件SKILL.mdAgent 在动手前先加载对应技能再按规则实现。项目官网入口技能注册表src/data/registry.ts技能总目录页逻辑src/lib/skill-catalog.ts站点设计规范本身就是范本DESIGN.md 一句话理解技能 给 Agent 的岗位手册加载哪份手册Agent 就按哪套规范干活。二、仓库结构速览技能如何组织目录/文件作用skills/baseline-ui/基线 UI 规范间距、排版、动画、性能红线skills/create-design-md/从现有仓库自动重建DESIGN.md设计语言文档skills/fixing-accessibility/ARIA、键盘导航、表单错误的审计与修复skills/fixing-motion-performance/动画卡顿、合成层、滤镜性能问题修复skills/improve-ui/只读审计现有界面产出可交接的改造计划skills/ui-skills-root/路由层帮 Agent 选中最小可用技能集每个技能目录下的 SKILL.md 都包含name、description前置元数据和具体规则可被 CLI 和 MCP 服务发现见 src/lib/agent-skills-discovery.ts 与 src/pages/mcp/server.astro。三、第一步用 CLI 让 Agent 自动选技能UI Skills 提供命令行入口Agent 或人都可以运行npx ui-skills start npx ui-skills categories npx ui-skills list --category motion npx ui-skills get baseline-ui核心是 skills/ui-skills-root/SKILL.md 定义的路由协议判断任务是否属于 UI 相关否则返回no skill needed识别任务所属类别用 CLI 查看该类别只加载 1 个最相关技能复杂任务最多 2~3 个绝不超过 3 个基于选中的技能上下文开始实现这套「先路由、后加载」的机制保证了 Agent 上下文干净、规范命中精准是企业级多 Agent 场景里避免技能过载的关键。CLI 实现参考 src/lib/ui-skills-cli.ts行为测试见 tests/cli.test.ts。四、第二步用 DESIGN.md 沉淀团队设计语言企业落地的第一个产出物应该是DESIGN.md——团队设计系统的单一事实来源。create-design-md技能skills/create-design-md/SKILL.md支持两种模式仓库模式从源码中的 token、主题、组件所有权中重建设计语言URL 模式从线上站点的计算样式中反推视觉规范标注为重建草稿生成的文档结构固定为## Overview、Colors、Typography、Layout 等段落配合 YAML frontmatter 存放颜色与字体 token。本仓库根目录的 DESIGN.md 就是活案例parchment 中性色阶、JetBrains Mono 等宽字体、克制的圆角与阴影全部以可校验的格式写出。✅ 团队约定DESIGN.md由设计师与 Agent 共同维护任何 UI 类技能执行前都先引用它。五、第三步用基线技能卡住 AI 界面劣化skills/baseline-ui/SKILL.md 是防止AI 界面垃圾感的第一道闸门规则包括动画只允许动transform/opacity等合成器属性禁止动画width、margin等布局属性交互反馈不超过 200ms必须尊重prefers-reduced-motion图标按钮必须带aria-label销毁性操作必须走AlertDialog禁止紫色多色渐变、发光效果等营销风样式配合 skills/fixing-motion-performance/SKILL.md按绝不模式 机制选择 滚动 滤镜的优先级表审计动画与 skills/fixing-accessibility/SKILL.md按可访问名称 键盘 焦点优先级审计交互团队可以形成日常开发 → 性能审计 → 可访问性审计的三段式质量流水线。六、第四步improve-ui 审计与多 Agent 交接当界面已经存在、需要改善而非重写时skills/improve-ui/SKILL.md 定义了严格边界只读审计不改产品源码只允许在design-plans/下产出计划证据三证明每条问题必须同时给出设计契约、运行时路径、修正方案否则丢弃计划交接产出的计划完全自包含交给另一个 Agent 执行这正是企业级多 Agent 协作的形态审计 Agent只读、保守与执行 Agent按计划动手职责分离天然规避 AI 越权改代码的风险。计划模板见 skills/improve-ui/references/plan-template.md。七、团队落地清单阶段动作涉及文件1. 立规范运行 create-design-md 生成团队DESIGN.mdskills/create-design-md/SKILL.md2. 接路由在 Agent 工作流中启用npx ui-skills start路由层skills/ui-skills-root/SKILL.md3. 卡质量所有 UI 任务默认加载 baseline-ui 基线skills/baseline-ui/SKILL.md4. 跑审计定期用 improve-ui 产出问题清单与改造计划skills/improve-ui/SKILL.md5. 进管线通过 MCP 服务将技能暴露给内部工具src/pages/mcp/docs.astro、src/lib/mcp-server.ts给管理者的三点建议① 技能数量宁少勿多遵循 root 技能的最多 3 个原则② 把DESIGN.md的变更纳入设计评审流程而非个人随意修改③ 用审计 Agent 的置信度列作为团队排期依据先修高杠杆问题。用 UI Skills 搭建团队级设计系统 Agent 工作流本质上是把设计团队的隐性经验变成 Agent 可加载、可审计、可交接的显性资产——规范一次沉淀全流程复用。【免费下载链接】ui-skillsSkills for Design Engineers项目地址: https://gitcode.com/GitHub_Trending/ui/ui-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表