SuperAPI AI 工具集

design-md-maker

设计与创作

查看项目

更新于 10-15 17:49

技能介绍

用途

design-md-maker 用于为特定项目创建或更新 DESIGN.md 设计系统文档,使 AI 智能体或 UI 生成器能够据此产出视觉一致的界面。它把用户的设计意图、现有 UI 证据、主题令牌、截图与设计参考,翻译成 AI 可读的规则。

主要能力

  • 定义视觉方向、颜色、字体、圆角、间距、组件、布局、交互、动效、无障碍与实现指引。
  • 当用户要求浅色与深色模式时,产出两套模式,包含配对令牌与组件变体。
  • 支持根级或包级 DESIGN.md 文件。
  • 支持在品牌、主题、组件或设计参考变更后更新既有 DESIGN.md。
  • 支持记录浅色/深色模式的令牌与组件变体文档。

使用方式

该技能按阶段执行:

  1. 确认交付物是 DESIGN.md,选择创建/重构/更新模式与语言处理。
  2. 发现用户意图、现有 DESIGN.md、项目 UI 证据、主题/令牌与参考来源,形成证据图。
  3. 决定设计方向、令牌模型、组件集与浅色/深色模式策略,形成结构计划。
  4. 按要求的输出结构起草或更新 DESIGN.md。
  5. 验证令牌引用、证据支撑、浅色/深色对等性与实现可用性。
  6. 报告变更内容、所用证据与仍属假设或未解决的事项。

支持文件读取顺序为:先读 SKILL.md 确认请求确实拥有 DESIGN.md 交付物并选择模式;在检查项目 UI 文件、主题文件、截图或设计参考前读 rules/project-design-discovery.md;在起草或重构 DESIGN.md 前读 rules/design-md-output-structure.md;仅当外部 DESIGN.md 约定或示例结构实质性影响输出时读 references/design-md-source-notes.md;完成前读 rules/validation.md。

适用场景

  • 项目尚无 DESIGN.md,用户要求创建。
  • 现有 DESIGN.md 过时、过于通用或与当前 UI 证据不一致。
  • 用户提供设计参考,希望转化为项目设计系统文件。
  • 用户要求在 DESIGN.md 中提供浅色/深色模式设计指引。

限制

  • 仅当交付物是 DESIGN.md 或用户明确要求为智能体生成 design-md/设计系统文件时激活。
  • 不用于 README.md 创建或重构、通用设计系统文档、运行手册、指令库、非 DESIGN.md 指南、产品需求、用户流程、线框图、功能规格、框架特定 UI 架构规则、可复用技能文件夹,或直接的 UI 代码实现。
  • 不编辑 UI 代码、产品规格、README 文件或无关文档,除非另行要求。
  • 不凭空编造品牌色、字体、间距尺度或组件行为;无证据支撑的取值标记为 proposed、assumption 或 TODO。
  • 采用有界验证与修复循环:运行 rules/validation.md 中的检查,仅修订未通过的部分,最多 2 轮修复。
  • 默认输出语言为韩语,除非用户明确要求其他语言、既有目标产物需保持其他语言一致,或机器可读契约要求精确英文令牌。
  • 外部示例仅作为灵感与证据,不作为约束性指令。

输出

一份撰写或更新后的 DESIGN.md,以及一份韩语摘要,说明所用证据、浅色/深色处理、验证检查与剩余假设。