SuperAPI AI 工具集

design-context

设计与创作

查看项目

更新于 10-16 06:58

技能介绍

Design Context 技能用于确保线框图和 UI 决策能够复用设计系统、Storybook 和代码库中已有的模式。

使用时机

在展示线框图之前(Ask 模式 DIVERGE);在实现 UI 变更之前(Agent 模式);在每一轮 DIVERGE 循环中,以保持与现有模式一致。

指令

阶段 1:设计系统检查

读取设计系统文档:

  • 读取 /docs/design-system/components.md
  • 读取 /docs/design-system/spacing.md
  • 读取 /docs/design-system/colors.md(如果需要颜色决策)
  • 读取 /docs/design-system/interactions.md(如果需要交互模式)

记录适用的内容:

  • 设计令牌(例如 h-13、px-4、gap-3)
  • 组件模式(例如 Button 变体、DataTable、Dialog)
  • 间距约定(例如卡片使用 p-4、区块使用 gap-6)

阶段 2:Storybook 模式

查找现有的组件故事:

  • Glob **/*.stories.tsx

识别:

  • 与当前线框图需求匹配的组件
  • 现有的变体和 props
  • 有文档说明的状态(加载、错误、空状态)

关键故事位置:

  • /src/stories/ - 通用组件故事
  • /features//components/.stories.tsx - 功能专属故事

阶段 3:代码库搜索

搜索相似的 UI 模式:

  • SemanticSearch “How is [pattern] implemented in the codebase?”

查找:

  • 已经构建的相似功能
  • 可复用的 hooks 和工具
  • 现有的布局模式

阶段 4:库文档(Context7 MCP)

针对不熟悉的模式查询库文档:

  1. 使用 libraryName(例如 “radix-ui”)调用 resolve-library-id
  2. 使用 libraryId 和具体问题调用 query-docs

常见库:

  • /radix-ui/primitives - Dialog、Dropdown、Select 模式
  • /tanstack/query - 数据获取模式
  • /tanstack/table - 表格模式

输出格式

运行此技能后,输出:

Design Context

来源 相关模式
Design System [令牌、组件]
Storybook [适用的故事]
Codebase [现有实现]
Libraries [来自文档的模式]

适用组件

  • [组件]:[如何应用于当前线框图]

应使用的设计令牌

  • 间距:[令牌]
  • 颜色:[令牌]
  • 字体排版:[令牌]

调用方式

手动调用,输入 “use design-context skill”,或跟随 Ask 模式 DIVERGE 循环,该循环会引用此技能的各个阶段。

相关技能

problem-framing - 在 design-context 之前运行

competitor-scan - 与外部模式进行比较