taiyi-restyle

name	taiyi-restyle
description	TaiyiForge 辅助 — UI 视觉改版任务清单（ui-restyle-tasks）。OpenCode / Claude / Codex / Cursor 通用。

taiyi-restyle

目的

当 UI-DESIGN.md 要求视觉层大面积改版（token、间距、组件皮肤）时，把 work 拆成可独立 PR 的清单，避免塞进单个 dev slice 导致 review 不可审、回滚困难。

何时使用

信号	建议
taiyi_assess 因 hasUi 推荐	考虑本 Skill
UI-DESIGN 含「改版 / 换肤 / 设计系统迁移」	必用
单组件颜色微调	否，留在 TASK 一条
无 UI（纯 API）	跳过

输入

• UI-DESIGN.md、DESIGN.md（前端边界）
• TASK.md（避免重复编号）
• 设计 token / Figma 链接 / 截图（若有）
• （可选）CONTEXT.md 中的前端目录约定

输出

• .taiyi/changes/<slug>/ui-restyle-tasks.md
• 可选：每项对应 截图基线路径 .taiyi/changes/<slug>/screenshots/before/

任务拆分原则

1. 按用户旅程切片，非按 CSS 文件：「登录页」「设置抽屉」优于「改 button.css」
2. 每项 ≤1 天 量级；更大则再拆
3. 每项须 可独立合并（feature flag 或隔离路由若需要，写在任务里）
4. 先 token / 基础组件，后 页面组合（减连锁冲突）
5. 无障碍与响应式为验收硬条件，不是可选 follow-up

任务清单格式

# UI Restyle Tasks: <slug>

> 来源：UI-DESIGN.md §… · 与 TASK.md 关系：补充视觉层，不替代功能任务

## Token / 基础层

| ID | 范围 | 变更 | 依赖 | 验收 |
|----|------|------|------|------|
| R1 | `styles/tokens.css` | 色板 v2 | — | 无回归 snapshot |
| R2 | `Button` 组件 | 圆角/阴影 | R1 | Storybook / 截图 |

## 页面层

| ID | 页面/流程 | 变更 | 依赖 | 验收 |
|----|-----------|------|------|------|
| R10 | `/settings` | 密度与侧栏 | R1,R2 | 桌面+移动截图 |

## 无障碍（横切）

| ID | 项 | 验收 |
|----|-----|------|
| A1 | 对比度 WCAG AA | axe / 手动表 |
| A2 | 焦点环可见 | 键盘录屏或截图 |

执行步骤

1. 读 UI-DESIGN：提取 Components、States、Breakpoints、A11y 四块需求
2. 盘点影响面：路由 → 页面组件 → 共享组件 → token（自下而上列表）
3. 建依赖图：R2 依赖 R1；页面依赖基础组件——在表中填「依赖」列
4. 写验收：每项必须 可证据化：
   • 截图对比（before/after 同视口）
   • 或设计工具标注一致
   • 或 data-testid + 视觉回归（若项目有）
5. 与 TASK.md 对齐：
   • 功能任务 ID（T3）与视觉任务 ID（R10）交叉引用
   • 同一文件同时改逻辑+皮肤 → 拆两 PR 或标明顺序
6. dev 执行：每个 R* 对应 taiyi-dev 一切片或子 PR；完成在 TASK 或 CHANGELOG 勾 ID

与主流程

taiyi-ui-design → taiyi-task
       ↓
  taiyi-restyle（大改版时）
       ↓
   taiyi-dev（按 R1,R2,… 切片）
       ↓
   taiyi-test（含视觉/a11y 证据）

• taiyi-test：至少一条用例覆盖 横切 A* 清单
• taiyi-review：对照 ui-restyle-tasks 勾完成情况；缺截图 → Request changes

质量自检

• 每项有 明确验收，无「好看即可」
• 引用 UI-DESIGN.md 章节号或组件名
• 移动端与桌面若 UI-DESIGN 有要求，任务表分别列验收
• 未引入未在 UI-DESIGN 出现的 scope（新页面须回 requirement）

与双线 harness

• 评审结论中的「必改项」编入 R* 或 A*
• Superpowers verification-before-completion：合并前须有截图或 CI 视觉检查记录

禁止

• 在 restyle 清单里加后端/API 功能（回 TASK）
• 单 PR 改完全站皮肤（除非 CHANGE 明确允许 big-bang）
• 跳过无障碍横切项
• 用 restyle 绕过 taiyi-ui-design 未决的 Open Questions