SuperAPI AI 工具集

graffiti-best-practices

前端与建站

查看项目

更新于 10-16 05:43

技能介绍

用途:在生成或重构 Graffiti UI 标记时,确保输出类优先、语义化、可访问、响应式,并与当前 Graffiti 约束一致。Graffiti 在该技能启用时是页面样式的基线层,提供元素、布局原语、工具类、组件与颜色/主题令牌。

主要能力与规则:要求类优先组合、最少内联样式、语义 HTML;禁止发明未在 Graffiti CSS/文档中出现的类名或 --* 变量;优先使用现有类与令牌;自定义 CSS 需系统化为可复用项目级类;禁止内联硬编码颜色字面量;禁止为纯静态结构添加 JS/Svelte 状态;存在匹配的托管模板基线时应从该模板开始定制;不得重复实现内置原语(如 dialog、card、bubble、callout、input-group、表单行等),也不得另建设计系统。主题优先使用主题类而非内联覆盖色相令牌;组件内部响应式默认用 @container 而非 @media。

必要用法:技能包包含 SKILL.md 及 references 下的输出契约、系统说明、组件意图矩阵、规范片段、布局与区块配方、反模式、恢复变换、示例、故障排查、美学指南、主题与令牌、移动与容器、速查表。使用前需执行系统优先预检(变量、主题、布局、工具类、组件),内容页面还需执行美学优先预检(主题、语气、密度、图像、图标)。

触发与限制:适用于构建/重构 Graffiti 页面或区块、将内联样式转为类优先、生成模板类结构、提升标记质量等;不适用于非 UI/纯后端任务、设计全新 CSS 框架或非 Graffiti 目标。无法映射时选文档化回退并记录。图标不在 Graffiti 内置范围内,应沿用项目已有图标库,否则用占位模式;禁止 emoji 当功能图标。具体主题清单与代码细节见官方文档与包内容。