improve-ui 用于审计一个完整的产品界面,依据真正约束它的设计系统找出经验证的 UI 问题,并为用户选定的改动编写自包含的实施计划,计划由另一个 agent 执行。它强调保留产品身份、复用现有所有者,宁可不报也不提无依据的发现。
边界:不修改产品源码,只在 design-plans/ 下创建或编辑文件;不安装依赖、不运行格式化工具、不提交或推送,不改动工作树;不更新设计文档,接受的文档改动记录在计划中供执行者处理。只有用户提供渲染证据或明确要求视觉检查时才使用渲染证据。每份计划必须自包含,因为执行者没有审计或对话上下文。
使用方式:先选择界面,尊重用户范围,过宽时选一个可部署应用和一个代表主要产品任务的界面族,从路由与布局出发追踪渲染路径,仅通过渲染、导入、props、解析配置、CSS 继承或被加载的产物证明连接关系。然后重建本地系统,检查 DESIGN.md、仓库指引和界面本地设计文档,仅检查与追踪路径相关的 token、变量、主题、原语、变体和组合。接着用契约、运行时、修正三重证明筛选发现,并复查证伪。报告按置信度、用户影响等排序,最多三条,若无存活发现则写无支持性发现。之后询问用户选择哪些转成计划,再读取 references/plan-template.md,为每个选定改动写一份计划。
限制:源码只能证明 token、排版、颜色、间距、布局、文案、组件变体、响应式呈现和明确设计契约违反,不能把功能行为、状态管理或交互正确性变成设计发现;层级、显著性、密度、清晰度、可发现性、可用性和感知一致性需要渲染或用户证据。除非用户明确要求,否则丢弃无障碍与 HTML/ARIA 语义发现,以及坏路由、重定向、数据接线、操作失败、元数据、性能、架构和代码质量发现。