用途:该技能用于指导编写 *.examples.ts 示例模板文件,适用于为组件创建新的示例文件、在已有示例文件中添加或更新示例模板、审查示例命名约定与结构,以及撰写或更新示例的 @summary JSDoc 注释。
主要能力与原则:示例名称使用 PascalCase,例如 Default、StatusFlat、FormSubmit;名称保持简洁,最多 1-3 个单词,用于说明该示例展示的内容;每个示例必须包含 @summary JSDoc 注释,说明是什么、为什么、何时以及如何使用;示例应为无状态 HTML 模板,用于演示 UI 模式。
命名模式:单词名称如 Default、Status、Size、Color、Disabled;复合名称如 StatusFlat、StatusIcon、FormSubmit、VerticalTabs;特殊前缀如 Legacy*、Invalid*、Valid*。
使用方式:资料强调在修改任何示例文件前,必须先查阅 @projects/site/src/docs/internal/guidelines/examples.md,并参考示例指南与文档指南。
限制:资料未提供具体安装命令、代码示例、收费或平台信息,相关事实暂未提供。