SuperAPI AI 工具集

authoring-patterns

前端与建站

查看项目

更新于 10-16 14:37

技能介绍

用途:把已验证的 playground 模板或 HTML 组合转为可复用模式文件(*.examples.ts),存放到 projects/internals/patterns/src/ 模式库中。适用于用户要求“保存为模式”“创建模式”“加入模式库”或将已验证原型编目的场景。

主要能力与流程:先定位待持久化的 HTML 模板(来自对话上下文或用户提供);用 api_validate(参数 { template, lang: 'html', format: 'json' })校验,须待 ok 为 true 且 summary.errors 为 0 后才继续;用 api_imports_get 推导所需 @nvidia-elements/core/*/define.js 导入,并始终在首行手动加上 import { html } from 'lit';;随后确定元数据:导出名用 PascalCase、1-3 个词,描述展示内容而非实现;文件名用 kebab-case 加 .examples.ts 后缀;默认导出 title 必须为 'Patterns/<Category>',已有分类包括 Authentication、Dashboard、Examples、Feedback、Heatmap、Keyboard Shortcuts、Logging、Media、Responsive、Search、Trend,优先加入已有同类文件并征询用户确认;撰写 JSDoc @summary(最多 400 字符,聚焦 UX,说明展示什么、为何有用、何时使用、如何改善体验),并始终带 @tags pattern。

组装:含 <script> 标签时用 render() 方法形式,否则用 render 箭头函数形式;向已有文件追加时需按字母序合并新导入、在文件末尾追加导出,不得改动已有导出与默认导出。最后写入文件并向用户确认路径、导出名、分类、使用的组件(nve-* 标签)与 @summary 内容。

限制:不得跳过校验;分类与命名须遵循 examples.md 指南;资料未提供具体命令、安装方式、收费或平台信息。