sdlc-ui-visual
UI 视觉还原
以设计稿为基准把运行中页面还原到位的闭环:基准 → 代码对照 → 稳定截图 → 多道比对 → 分级修复轮 → 功能回归 → 汇报。与 sdlc-test 分界:那边验「行为对不对」(源码只读),这边验「长得像不像设计稿」(以设计稿为基准、允许改样式代码)。
栈适配:方法论栈无关;Vue2 + element-ui 栈姿势见 references/stack-vue2-element.md(换栈先读,日常执行不加载)。
前置依赖:python3 + Pillow(compare.py;缺依赖时脚本会提示 pip3 install Pillow);figma-context-mcp(Figma 输入,server 别名以实际安装为准);浏览器自动化 MCP(chrome-devtools,不可用时按 pipeline 降级链切 Playwright)。
产物目录(相对目标项目根):.ui-check/<目标名>/——独立于 sdlc/ 工作区(无 sdlc 工作区也成立,有则互不依赖)。目录内二进制产物多,首次创建时提示用户把 .ui-check/ 加入 .gitignore。
状态落盘(run.md):.ui-check/<目标名>/run.md 是唯一状态源——七步进度、差异分类台账、待用户问题、已拍板记录全在其中,每步结束即更新;中断后重开会话 = 读 run.md 头部进度续跑,禁止凭对话记忆恢复、禁止推翻台账中已拍板分类。模板见 references/templates.md。
步骤 0:环境与可达性
浏览器会话可用、目标路由可达、登录态有效。遇登录墙(SSO 等)不自行绕:请用户人工完成登录与页面导航,之后截图/断言/比对全自动化(人工分工要记入 run.md)。dev server 先探测再决定是否启动;浏览器工具冲突时按 references/pipeline.md 降级链切换。