zjsthmjialin/commercial-ui-ux-codex-skill

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