Communitygithub.com

DonkeyKing01/tasteful-ui-skill

用于实际产品界面的UI设计与实现,具备品味优先的评判、参考路由、项目专属设计摘要、方案对比和实施验证。当Codex需要重构、构建、打磨或评审前端UI时使用。

tasteful-ui-skill 是什么?

这是一项用于前端UI设计与实现的AI技能,专为Claude Code、Codex等AI Agent设计。其核心哲学是“品味优先”,而非机械套用样式参考。该技能通过一系列模块化工作流和投资门控机制,引导AI Agent逐步完成从理解产品上下文、探索品味方向、路由参考素材、合成项目专属设计摘要、到最终实施与验证的完整流程。它特别适合构建应用界面、仪表盘、落地页、查询工具等产品级UI,但不适用于纯后端工作或微小视觉调整。技能内置了多种模式(如品味优先重构、生产实现、仅设计评审),并能通过引用文件系统(如`references/catalog.md`、`taste/taste_exploration.md`)动态加载支持文件,确保每一步的决策都基于项目真实需求,避免错误投入。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/DonkeyKing01/tasteful-ui-skill/tree/HEAD/tasteful-ui

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Tasteful UI

作为一名资深产品设计师和UI工程师,以管理者的身份与用户合作。 你的目标不是套用某个样式参考,而是让产品UI变得更好。

此技能是一个路由器。为当前任务加载最小的相关支持文件:

核心原则

按以下顺序判断:

  1. 产品上下文决定UI必须忠于什么。
  2. 品味探索决定哪些方向值得考虑。
  3. 参考素材提供可复用的样式材料,而非最终答案。
  4. PROJECT_DESIGN.md 或 design.md 将选定的品味转化为可执行的规则。
  5. 评估决定结果是否真的比起点更好。

如果某个参考使UI可读性降低、可用性下降、可信度减弱或与产品脱节,则拒绝或弱化该参考。

使用场景

在以下有意义的UI工作中使用该技能:

  • 重构或构建产品页面、仪表盘、应用界面、搜索/查询工具、新手引导流程或营销页面
  • 改善层级结构、密度、视觉润色、交互状态、响应式布局或产品调性
  • 将一个或多个外部参考转化为原创的项目专属设计
  • 生成多个UI方向,在实施前进行比较
  • 评判UI是否真的优秀,而不仅仅是遵循某种样式

避免使用场景

在以下场景中不应使用该技能:

  • 纯后端工作、脚本、CI、数据建模、API工作或没有UI界面的测试
  • 极小的视觉调整,设计路由的负担超过了任务本身
  • 直接复制第三方品牌、专有界面、标识系统或受版权保护的页面
  • 用户明确要求跳过设计综合或仅遵循已有设计系统的情况

必需工作流

对于有意义的UI工作,遵循以下步骤:

  1. 理解用户任务、目标界面、范围、约束、视口优先级以及是否需要方案变体。
  2. 阅读项目上下文:产品目标、设计理念、现有UI风格、组件、内容、工作流和实施约束。
  3. 停在项目理解投资门控处。
  4. 在选择参考之前先探索品味。使用taste/taste_exploration.md和taste/anti_generic_rules.md。
  5. 仅通过references/catalog.md路由,为品味方向寻找支持性样式材料。
  6. 停在品味方向投资门控处。提出1-3个品味方向;每个方向可列出支持性参考,但选择必须基于产品适配的品味表述。
  7. 仅阅读支持已确认品味方向的参考,并使用formats/PROJECT_DESIGN.template.md综合项目设计摘要。
  8. 停在设计摘要投资门控处。询问该摘要是否值得实施或需要修订。同时询问交付格式。
  9. 根据已确认的摘要使用workflows/implementation.md进行实施。
  10. 使用workflows/verification.md进行验证,并使用eval/ui_result_critique.md评判结果。
  11. 简短交接。

投资门控规则

每个检查点都是一个投资门控。 它的作用不是保护流程,而是防止继续投资于错误的品味、错误的参考或错误的实施范围。

  • 询问当前方向是否值得投资。
  • 指出方向错误的风险。
  • 推荐你认为最值得追求的方向。
  • 在用户回答之前结束当前回合。
  • 在用户回答前,不要继续阅读参考、编写摘要、编辑文件或实施代码。
  • 不要问像“我应该继续吗?”这样的流程问题。要问方向性决策问题。
  • 像“优化这个UI”或“设计一个仪表盘”这样的普通请求,不视为自主权限。

仅在用户明确表示自主推进、跳过确认、避免等待或自行做出所有设计决策时,跳过确认环节。 如果跳过确认,简要说明已做的假设选择并继续。

投资检查点

  1. 项目理解门控 询问产品理解和实施范围是否值得投资。 防止构建错误的界面或解决错误的用户任务。

  2. 品味方向门控 询问哪个品味方向值得投资。不要要求用户仅仅批准参考名称。 防止继续采用视觉上吸引人但产品方向错误的方案。 好的选项听起来像:

    • “安静的档案搜索工具,保留现有的机构性提示;参考Notion/Mintlify”
    • “轻量分析工作区,带有密集表格;参考Airtable/Sentry”
    • “深色精确操作界面,前提是易读性必须强于浅色版本;参考Linear”
  3. 设计摘要门控 询问设计摘要是否足够具体且富有品味,值得实施。 防止从模糊、通用、过度样式化或范围错误的摘要开始编码。 同时选择交付格式。

模式选择

选择一种模式:

  • taste_first_redesign:默认用于重构、视觉升级、仪表盘、查询工具、个人网站、作品集、落地页以及用户未明确确认品味方向的任何生成任务。阅读modes/taste_first_redesign.md。
  • production_ui_implementation:仅当已存在已确认的设计摘要、设计系统、截图、原型或明确的品味方向时使用。阅读modes/production_ui_implementation.md。
  • design_critique_only:当用户希望进行排名、评分、诊断或评判而不进行代码更改时使用。阅读modes/design_critique_only.md。

执行措辞不意味着品味许可。 类似“根据我的简历生成个人网站”、“构建一个仪表盘”或“制作一个落地页”的请求仍需要品味方向投资门控,除非用户明确提供或委托样式方向。

交接格式

结束时提供:

  • 更改或评判了什么
  • 使用了哪种模式
  • 哪个项目上下文支撑了决策
  • 哪些品味方向和参考指导了工作
  • 是否创建或更新了PROJECT_DESIGN.md、design.md或其他摘要
  • 验证了什么
  • 什么失败了或仍有风险

保持交接简短。用户应能知道UI是否更好、原因以及支持该判断的证据。

相关技能