用途
ui-anti-slop-codex 是一个面向 Codex 的前端界面设计与实现工作流技能。它的目标是把 Codex 的界面工作约束为产品设计任务,而不是通用的“填屏幕”式产出:先理解现有设计事实,再确定界面类型与参考风格,声明视觉契约后实现,并在交付前验证实际渲染效果。
除非用户明确表示只讨论、不实施,否则每个界面任务都应遵循这套流程。
主要能力与流程
- 以仓库事实为依据:检查现有 UI 文件、路由、全局样式、组件库、图标库、包管理器、截图、设计文档和 DESIGN.md;优先沿用既有设计系统与本地组件。若存在 DESIGN.md,应在做视觉决策前阅读;若任务涉及创建或编辑 DESIGN.md,则加载
references/design-md-protocol.md。 - 分类界面类型:将任务归类为 landing、营销站点、平台应用、仪表盘、管理或内部工具、编辑器或创作工具、结账或定价、文档或开发者关系、移动端 UI、游戏或交互界面中的一种或多种,并加载
references/surface-contracts.md中对应的界面契约。若经仓库检查后界面类型或目标受众仍不明确,只询问一个最关键的问题并给出建议答案;不询问仓库本可回答的事实。 - 选择参考风格族:优先使用用户明确给出的参考;否则从
references/reference-families.md中选择与界面类型、受众、业务目标与信息密度匹配的风格族。参考只作为设计语汇,不构成克隆许可。 - 在编辑 UI 前声明视觉契约:契约保持精简且可操作,包含 Surface(界面类型)、User job(用户任务)、Reference family(参考风格族)、Design source(设计来源)、Density(信息密度)、Layout(布局)、CRUD create mode(创建模式)、Required states(必需状态)、Forbidden tells(禁止特征)、Verification(验证方式)。设计来源须说明是现有仓库 UI、DESIGN.md、用户参考、生成的参考还是推断的风格族。当界面包含记录、表格、管理流程、仪表盘或平台 CRUD 时,必须给出创建模式(内联、模态框、抽屉或独立页面),并依据任务复杂度与记录浏览需求说明理由。禁止特征应针对该界面具体列出,而非通用清单。
- 按契约实现:先构建真正可用的界面,不把平台界面做成 landing page,也不把公开落地页做成产品驾驶舱。有现成组件、token、字体、图标集、图表库、路由与状态模式时优先复用;仅当仓库没有可用设计来源或用户要求重设计时,才引入新的视觉语言。
- 交付前视觉验证:加载
references/codex-verification.md,在可行时运行应用或打开产物,有浏览器工具时截取桌面与移动端截图;对照视觉契约评审渲染输出,并在最终回复前修复可见问题。
核心规则
- 界面类型优先,视觉风格服从屏幕的功能目标。
- 设计 token 优先:若存在 DESIGN.md 或设计 token,它们是设计事实来源。
- 产品实感胜过装饰:使用真实产品 UI、真实媒体、真实数据状态或明确的占位内容,避免用 div 拼出假截图。
- 信息密度匹配使用频率:日常工具需要快速扫读,公开页面需要清晰的卖点与证明。
- CRUD 浏览与 CRUD 创建是不同交互模式:除非内联录入是核心产品行为,否则不要把常驻创建表单放在主表格或列表旁或下方。
- 每个界面只用一个视觉系统:不混用无关的配色、图标族、圆角体系、阴影与字体风格。
- 禁止静默套用通用默认值:默认紫色渐变、装饰性卡片、虚假指标、嵌套卡片、含糊文案、不可见按钮文字、无理由的大片留白,除非契约给出理由。
- 验证属于任务的一部分:在文字重叠、移动端破损、图表不可读、按钮对比度不足或设计与契约矛盾时,不应结束任务。
参考文件路由
references/design-md-protocol.md:存在 DESIGN.md、用户提及 DESIGN.md、工作创建可复用设计系统,或大范围重设计需要持久视觉规则时加载。references/surface-contracts.md:用于界面分类及所需 UI 行为。references/reference-families.md:选择视觉参考风格族,或用户指定某产品/品牌作为灵感时加载。references/codex-verification.md:在最终确定任何视觉 UI 实现或评审前加载。
输出纪律
大幅 UI 工作开始改代码前,先说明视觉契约;实现过程中保持简短更新并与契约对应;最终回复中报告关键 UI 变更、已执行的验证,以及无法运行的检查项。
适用场景与限制
适用于 Codex 参与前端界面构建、评审、修复、样式设计、重设计与改进的场景。资料未提供该技能的独立安装命令、收费方式、支持平台或效果量化数据,这些内容暂未提供。