SuperAPI AI 工具集

frontend-system-discipline

前端与建站

查看项目

更新于 10-16 01:33

技能介绍

用途:这是一项复用与结构类技能,用于前端代码可能偏离设计系统,或某次改动会诱使智能体发明没有真实归属的局部令牌、辅助层或样式分桶时,把 UI 工作绑定到既有系统上。

适用场景:涉及样式、令牌、布局或组合方式的组件与页面实现;主题、设计令牌或语义样式更新;引入局部辅助函数、常量或包装组件的重构;styled-component、CSS 模块或样式文件组织工作;聚焦前端复用、令牌纪律或组件结构审查的代码评审。

核心规则:既有设计系统已能表达需求时,不得发明新的视觉令牌;不得为页面本地复制主题值、调色板值、间距比例、字体或动效值;内联更清晰时不得抽取琐碎辅助函数、常量或样式片段;不得为单次使用创建 helpers.ts、constants.ts 或 styles.ts 分桶;不得仅为重命名或原样转发 props 而包装基础组件;除非拆分形成真实的归属或复用边界,不得把样式拆到另一个文件;兄弟组件已有共享基础组件时不得重复组合模式。

思考顺序:添加前端结构前依次评估既有设计系统组件或基础组件、既有语义主题令牌、既有共享组合模式、本地内联实现,仅在具备明确复用或策略价值时才新增共享基础组件。

主题与组合规则:优先复用语义令牌并保持其语义化而非页面专属;值稳定、有意义且被复用或预期复用时才提升为令牌;产品专属或屏幕专属值在复用被证实前保持本地,不因一个字面量在同一文件出现两次就建令牌。一次性转换保持内联,辅助函数仅在复用、承载领域含义或显著澄清复杂渲染路径时抽取;优先用 props 驱动组合而非包装器。样式文件应贴近真正局部的组件,以所属组件或共享基础组件命名,仅在多个使用方确实受益时共享。

完成标准:未引入琐碎辅助或包装层,未抽取无共享意义的一次性常量,主题令牌已存在处无局部重复,样式文件体现归属与复用,最终结构不比起始更复杂。使用时应报告复用了哪些设计系统或主题基础组件、哪些令牌或常量保持本地及原因、拒绝了哪些辅助或包装、样式文件如何组织、新增了哪些共享基础组件及其复用或策略理由。资料还列出 references/design-system-theme.md、references/composition-and-styles.md、evals/evals.json 作为参考。具体平台支持与安装方式暂未提供。