SuperAPI AI 工具集

usage-guidelines

设计与创作

查看项目

更新于 10-16 01:31

技能介绍

用途:为单个具名组件编写可执行的使用规范,覆盖使用契约:何时使用、何时不使用、边界情况、反模式与无障碍指导,并额外生成约150词的速查卡。

主要能力:先核对 SKILL.md 引用路径是否存在,若缺失提示按 1-INSTALL.md 重装并运行 verify-install.sh;读取 .ai/metadata/<Component>.metadata.json、组件源码、stories、文档、Figma 及系统语气指南;要求用户提供组件名称、变体、既有文档、团队实际观察到的误用模式、既有无障碍要求。所有作为事实陈述的行为需可溯源,否则标为 unverified,无证据的误用标为 anticipated。

输出结构:Overview、When to use、When not to use、Variants and configurations、Edge cases、Accessibility(含键盘、焦点、屏幕阅读器、最小触控目标、对比度,基线 WCAG 2.2 AA)、Anti-patterns(含 what happens、why harmful、what to do instead、how to detect)、Content guidelines、Related components,以及速查卡。

适用场景:设计系统组件文档编写、代码评审与设计评审前的规范准备。

限制:无法找到组件时应停止并询问;版本号需询问而非推断;不掌握全部组件事实时不得编造;缺少引用材料时需说明输出未基于该资料。