| name | visual-iteration-workflow |
| description | 用于页面和应用界面的视觉迭代工作流判断，提醒 Agent 在可见 Web 页面上做 UI/UX 修改时优先考虑浏览器点选式迭代，尤其是 Impeccable Live Mode。用户提到“点击修改页面”“点某个位置改”“这里看着不对”“现场看页面调设计”“生成几个变体”“局部视觉修改”，或在浏览器预览中指出 layout/spacing/overlap/color/typography/copy/motion 等具体问题时使用。也用于设计初稿生成后，提醒在继续手动 patch 前先考虑 Live Mode。不用于纯后端、非视觉重构、CLI-only 工作或一次性静态解释。 |
视觉迭代工作流
使用这个 Skill 作为视觉设计迭代的路由和安全收尾流程。它的核心作用不是替代 impeccable，而是在用户正在看页面、想改某个具体视觉位置时，提醒 Agent 优先考虑浏览器里的点选式迭代。
判断规则
同时满足以下条件时，优先使用 Impeccable Live Mode：
- 任务涉及 UI/UX、视觉设计、布局、间距、字体、颜色、动效、响应式、文案位置或组件外观。
- 目标是可以在浏览器中打开的 Web 页面或应用界面。
- 用户指向可见位置，例如“这里”“这个位置”“点选修改”“现场看看”“生成几个版本”，或在看完预览后要求局部视觉调整。
以下情况使用普通文件编辑：
- 任务是纯后端、纯数据、纯 CLI，或无法通过浏览器视觉检查。
- 用户只是要先做一个大范围初稿，而且还没有可预览页面。
- Live Mode 需要明显额外配置，而用户明确想要快速静态改动。
- 目标是纯原生
ios、android 或 adaptive 项目，并且没有 Web 预览。
推荐流程
- 检查当前会话是否可用
impeccable Skill。可用时，使用它的 Live Mode 说明；在运行 live 命令前读取 SKILL.md 和 reference/live.md。
- 如果用户正在浏览器里看页面，且要改具体视觉问题，优先建议 Live Mode，而不是直接 patch 文件。
- 如果用户同意，或用户本来就要求点击式编辑，从最小且正确的项目根目录启动 Live Mode，不要从过大的父级通用工作区启动。
- 如果 Impeccable 提示缺少上下文，只在相关页面/产品目录内创建或更新
PRODUCT.md、DESIGN.md 和 .impeccable/live/config.json。不要把通用父项目污染成某个具体产品的上下文。
- 当
file:// 页面无法稳定加载注入脚本或浏览器事件时，优先用本地 HTTP 预览地址。
- 进入 Live poll loop，等待用户提交
generate、steer、accept、discard 或 exit 事件。
- 处理
generate 时，生成多个有差异但保持品牌一致的变体。除非用户明确要求偏离原风格，否则保留现有设计身份。
- 用户
accept 后，必须先完成 cleanup，再继续 poll：把被接受的 CSS 合入正式源码，移除 impeccable-carbonize 标记，移除 data-impeccable-* 包装，删除未接受变体的死代码，并在需要时运行 live-complete.mjs。
- 用户结束后，停止 live helper，移除注入脚本，停止本次临时启动的预览服务器，并确认源码中没有 live 标记残留。
安全检查
最终源码中不得留下：
impeccable-livelive.jslocalhost:8400impeccable-carbonizeimpeccable-variants-startdata-impeccable-variant- 临时
@scope 变体 CSS
不要做宽泛的进程清理。只停止本次启动的 live helper 和临时预览服务器。如果启动了临时服务器，记录端口，收尾时只停止监听该端口且确认为本次预览用途的进程。
如果 Live Mode 改动了生成文件、临时 wrapper 或 fallback 文件，先按 Impeccable 的 fallback/accept cleanup 规则清理，再向用户报告完成。
对用户的沟通方式
当适合 Live Mode 时，直接简短说明：
这个适合用 Impeccable Live Mode：你在页面上点具体元素、写修改意见，我生成几个变体，你接受后我再写回源码并清理临时标记。
Live 会话中保持操作型更新：说明 helper 已启动、正在等待点击事件、变体已生成、正在清理接受后的临时标记、Live Mode 已停止。
回退方案
如果 Impeccable 不可用，退回最佳浏览器检查流程：打开或 serve 页面，观察可见问题，修改源码，刷新验证，并说明本次未使用 Live Mode 的原因。
