zjsthmjialin/commercial-ui-ux-codex-skill

Commercial UI/UX Codex Skill（中文说明）

Awesome DSH Plugin

commercial-ui-ux 是一个面向 Codex 的商业 UI/UX/GUI skill，用于产品界面的设计、评审、修复和实现。

它的重点不是让 Codex “换个配色”或“做得更好看”，而是让 Codex 在处理界面任务时优先理解用户任务、业务流程、交互风险、既有设计系统、可访问性和验收标准。

English README | GitHub 预发布版本

联系作者：zjsthm@gmail.com
作者网站：zjsthm.pro

一句话说明

这个 skill 帮助 Codex 把商业界面工作从“视觉包装”推进到“可用、可验证、可维护的产品界面方案”。

当前状态

| 项目 | 状态 |
| --- | --- |
| Skill 名称 | commercial-ui-ux |
| 当前版本 | 0.1.0-rc.1 |
| 发布状态 | 公开候选版本，不是最终非 RC 版本 |
| 主要用途 | 商业 UI/UX/GUI 设计、评审、修复和实现 |
| 适合场景 | SaaS、仪表盘、管理后台、工作流、表单、表格、移动端业务界面 |
| 不适合场景 | Logo、纯插画、海报、装饰换肤、合规判断、欺骗性界面 |

适合解决什么问题

很多 UI 需求只写“做漂亮一点”，最后容易变成堆卡片、堆渐变、堆视觉词。这个 skill 会推动 Codex 先回答更关键的问题：

- 用户是谁，要完成什么任务？
- 这个流程需要哪些信息、状态和保护措施？
- 既有产品中的信息架构、组件语义、路由、密度和视觉 token 哪些必须保留？
- 哪些地方需要 loading、empty、error、disabled、permission、approval、rollback、recovery 状态？
- 最终结果应该如何检查，而不是只用“高级”“现代”“好看”来描述？

因此，它更适合产品界面、工作台、管理系统和高密度业务流程，而不是纯视觉风格探索。

安装

把公开仓库克隆到 Codex skills 目录，并保持文件夹名为 commercial-ui-ux。

Windows PowerShell

git clone https://github.com/zjsthmjialin/commercial-ui-ux-codex-skill "$env:USERPROFILE\.codex\skills\commercial-ui-ux"

macOS / Linux

git clone https://github.com/zjsthmjialin/commercial-ui-ux-codex-skill ~/.codex/skills/commercial-ui-ux

安装后，重启或刷新 Codex，就可以让 Codex 使用 commercial-ui-ux 处理商业 UI/UX/GUI 工作。

典型请求

使用 commercial-ui-ux 设计一个 B2B SaaS 客户健康度仪表盘。

任务类型：新建产品界面
目标用户：客户成功经理和销售负责人
平台：响应式 Web，桌面优先
核心任务：发现高风险客户、理解风险原因、分配跟进任务
已有设计系统：浅色主题、8px 圆角、紧凑表格密度
视觉来源：按产品上下文推断
必须包含：客户列表、健康分、筛选器、空/加载/错误状态、受保护的批量操作
避免：营销式 hero、装饰性渐变、无关重设计

Codex 应该如何读取

普通任务从 SKILL.md 进入，然后只读取当前任务需要的文件。

| 场景 | 读取文件 |
| --- | --- |
| 普通 UI 设计或实现 | docs/01-commercial-ui-ux-rules.md |
| 判断边界、是否拒绝或是否需要重新限定范围 | docs/02-skill-boundaries.md |
| 处理美感、可用性、商业目标和可访问性的取舍 | docs/03-design-constitution.md |
| 帮助用户写出更清楚的请求 | docs/05-usage-guide.md |
| 声称 UI 工作完成前的质量检查 | docs/06-quality-gates.md |
| 用户没有提供品牌规范或参考图 | docs/07-visual-strategy-inference.md |
| 中文公开项目说明 | docs/08-project-overview.zh-CN.md |
| 需要行业化界面模式 | docs/09-industry-taxonomy.md、docs/10-industry-template-library.md |

维护、验证、历史证据和生成物不属于普通运行时读取路径。

公开核心包包含什么

- SKILL.md
- SKILL.zh-CN.md
- README.md
- README.zh-CN.md
- CHANGELOG.md
- VERSION
- docs/01-commercial-ui-ux-rules.md
- docs/02-skill-boundaries.md
- docs/03-design-constitution.md
- docs/05-usage-guide.md
- docs/06-quality-gates.md
- docs/07-visual-strategy-inference.md
- docs/08-project-overview.zh-CN.md
- docs/09-industry-taxonomy.md
- docs/10-industry-template-library.md

普通安装路径不包含什么

公开安装核心包有意不包含以下内容：

- 维护脚本；
- 原始验证轮次；
- 生成截图；
- 历史交接记录；
- 导出的评测包；
- 本地发布产物；
- plugin 元数据；
- 最终非 RC 版本材料。

证据状态

当前候选版本基于 P6 公开发布准备证据组：

| 证据组 | Baseline | With skill | 增量 |
| --- | ---: | ---: | ---: |
| P6-H1 任务建模 | 76/100 | 98/100 | +22 |
| P6-H2 既有系统修复 | 64/100 | 98/100 | +34 |
| P6-H3 风险状态泛化 | 68/100 | 98/100 | +30 |

平均增量约为 +28.7，高于本项目使用的 +25 发布准备门槛。

这支持一个有限而明确的结论：该 skill 能提升 Codex 在任务建模、既有产品修复、工作流状态、受保护操作、风险恢复和移动端连续性方面的表现。它不等于领域合规、生产可用或最终设计正确性的自动保证。

边界声明

这个 skill 不是：

- Logo、海报或插画生成器；
- 纯配色、纯换肤或视觉风格目录；
- 产品、设计、可访问性、安全、法律、医疗、金融或合规审查的替代品；
- 用于欺骗性默认值、隐藏成本、虚假紧迫感或暗黑模式的工具。

对于既有产品，默认原则是保留信息架构、组件语义、路由、状态、信息密度和视觉 token，除非用户明确要求重新设计。

版本

当前版本：0.1.0-rc.1

GitHub 预发布版本：https://github.com/zjsthmjialin/commercial-ui-ux-codex-skill/releases/tag/0.1.0-rc.1

这是候选版本，尚未分配最终非 RC 公共版本。

作者

- 作者：zjsthm
- 邮箱：zjsthm@gmail.com
- 作者网站：zjsthm.pro
- 微信：63656299