UI 视觉设计 / 系统课时

贯通设计变更到上线的审批流程

贯通设计变更到上线的审批流程

一次按钮配色修改可能已通过设计评审,却在令牌包、组件包和业务应用中形成三个不同版本。本篇用一条可追踪的变更单贯通评审、PR、测试、发布和升级,并预留失败时的回滚入口,让每个放行决定都有依据。

学习目标

  • 为设计变更建立唯一编号、责任人和验收证据。
  • 配置设计评审、PR 检查与应用上线的分级关卡。
  • 按版本映射升级业务项目,并在故障时恢复已验证版本。

用一张变更单锁定范围

假设需求 DS-142 将按钮的 color.action.primary 从 #2563EB 改为 #1D4ED8。不要只发一张改色截图;在任务卡及关联 PR 中填写以下字段,让设计和工程讨论的是同一次变更。

字段 DS-142 的示例
设计证据 Figma 文件链接、Button 前后对比、设计评审结论
影响范围 Light/Dark 模式、Button Primary/Hover/Focus、Web 与 App
接口判定 令牌名称和组件 Props 不变;仍需验证视觉兼容性
目标版本 令牌包 1.5.1、组件包 2.8.1,按团队 PATCH 规则发布
回退基线 令牌包 1.5.0、组件包 2.8.0、应用上一个稳定构建

先确认新颜色下按钮文字对比度符合项目验收线:普通文本至少 4.5:1,焦点样式与 Disabled 状态也要单独复查。视觉变化即使不改 API,也不能跳过设计复核。

按责任人设置四道审批关卡

  1. 设计评审:设计负责人核对 Figma 前后状态、Light/Dark 和受影响页面;不通过时退回修改,不进入代码发布。支持分支的 Figma Organization/Enterprise 团队可先审分支再合并;其他团队用独立草稿与评审记录,不假设有分支审批功能(见 Figma 分支权限)。
  2. 令牌与组件 PR:工程负责人将 DS-142、Figma 评审链接写入 PR;检查引用有效性、Button 状态测试和视觉差异。令牌和组件可以分开提 PR,但都必须指向同一变更单。
  3. 版本发布审批:维护者确认变更级别、两个包的兼容关系、变更日志和可用的上一版;通过后从受审提交构建并发布,不直接用未审核工作区打包。
  4. 业务应用升级审批:应用负责人提交依赖升级 PR,在预发布环境验证关键页面;验收通过才允许生产发布,并记录部署版本与负责人员。

设计变更从评审到应用上线的审批与回滚流程

Figma 的分支合并不等于已发布共享库。设计审批通过后,可在库源文件主文件的 Assets → Libraries → This file → Publish 发布更新;使用方仍需在自己的设计文件中审核并接受库更新(见 发布共享库)。把该操作的时间和结果写回 DS-142。

让 PR 检查成为合并条件

片段示例:以下为完整 GitHub Actions 工作流文件 .github/workflows/design-system-ci.yml,但依赖仓库已有 package-lock.json,以及 package.json 中可执行的 test:tokens、test:components、build 脚本。两项测试应分别覆盖令牌引用和组件状态;没有这些脚本时须先实现,不能把检查视为已配置。

yaml
name: design-system-ci
on:
  pull_request:
    branches: [main]
permissions:
  contents: read
jobs:
  design-system-ci:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v7
        with:
          node-version: '22'
          cache: npm
      # 锁定依赖版本,避免 CI 与本地解析出不同依赖
      - run: npm ci
      # 两组检查对应令牌引用与组件状态
      - run: npm run test:tokens
      - run: npm run test:components
      - run: npm run build

预期结果:依赖安装、两组测试和构建全部成功时,PR 的 design-system-ci 检查显示成功;缺少脚本或测试失败时检查失败。工作流本身不会自动要求审批,还须在 GitHub 仓库 Settings → Branches 的 main 保护规则中开启 PR 审批,并将 design-system-ci 设为必需状态检查。建议至少两位独立审阅人;其中设计批准仍须通过变更单中的 Figma 记录核实,不能用代码检查代替。具体选项见 GitHub 分支保护规则。

按固定版本升级并验收

审批完成后,分别发布令牌包 1.5.1 与组件包 2.8.1,在发布说明里记录 DS-142、适配范围和迁移要求。业务项目的升级 PR 应提交依赖清单和锁文件,避免只改声明而实际安装了旧版本。

在预发布环境建立最小验收矩阵:视口 375×800 和 1280×800,主题 Light/Dark,按钮 Default/Hover/Focus/Disabled;共检查 2×2×4=16 组组合。逐组对照已批准的 Figma 状态,核对文字对比度、焦点可见性与控制台报错。测试未通过则阻止该应用上线,但不要求其他未受影响应用同步升级。

上线记录至少包含应用提交号、令牌包版本、组件包版本、发布时间和验收链接;只有当这些信息能对应到 DS-142,才能判断线上使用的是哪套设计。

保留能真正执行的回滚路径

假设应用升级后焦点描边消失,先暂停继续推广,重新部署上一份已验证的应用构建,并确认它锁定令牌包 1.5.0、组件包 2.8.0。检查线上 Button 焦点与主题状态已恢复,再把事故、回滚提交和待修复项关联到 DS-142。

最后在变更单中记下“回滚触发条件、稳定构建标识、复验结果、重新放行人”。这四项缺一项,下一次升级就无法安全复用本次处理结论。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

贯通设计变更到上线的审批流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通