SuperAPI AI 工具集

design-md

设计与创作

查看项目

更新于 10-16 02:32

技能介绍

用途:为仓库生成根目录 DESIGN.md,向 AI 智能体与人类说明该仓库 UI 的构建方式,并附带一份可移植的前端设计技能文件。文档是代码的下游产物,只描述已存在的设计语言,或在用户批准后提出新方案,绝不把自创设计语言当作事实,也不为迎合文档而重构现有 UI。

主要能力:产出根目录 DESIGN.md(基于证据、引用真实文件与 token);创建 .agents/skills/frontend-design/SKILL.md 可移植设计准则(排版、表面、动效);在 AGENTS.md 的 Quick Links 中加入指向 DESIGN.md 的链接。

使用方式:先做 Phase 0 审计与分类。审计证据包括 package.json 中的框架与 UI 库、token 层(globals.css、tailwind.config.*、主题文件)、字体加载方式、组件系统、动效实现,以及应用中最精致的 3–5 个界面。随后归入三种模式之一:Mode A 文档(已有设计语言但无文档,做提取);Mode B 合并(已有设计文档,合并去重、保留唯一规则);Mode C 提案(全新项目,先写一页提案到 docs/plans/design-language.md,等待用户批准后再写 DESIGN.md)。之后按模板写 DESIGN.md、创建技能文件、加链接,并执行验证。

适用场景:需要让智能体在仓库内一致地构建 UI、统一设计语言契约的前端或全栈项目。

限制:不得为匹配文档而重构组件;Mode A/B 不得在记录时“改进”设计语言,改进想法放入 Open questions;不得照搬其他产品的设计语言;文档须引用真实存在的文件与 token,宁短勿错;Mode C 必须先获用户批准。验证要求所有引用路径可解析、token 与字体在代码中存在、AGENTS.md 链接有效。具体模板内容与命令资料未完整提供。