SuperAPI AI 工具集

template-validation

编程与开发

查看项目

更新于 10-16 00:05

技能介绍

用途:在打包发布到 NuGet 前校验自定义 dotnet new 模板的 template.json,捕获导致模板静默失败、生成损坏项目或不出现在 dotnet new list 中的常见编写错误。

主要能力:按 8 类规则系统检查——必填字段(identity、name、shortName 等)、identity 格式、shortName 与 dotnet new 子命令冲突、符号(symbols)定义、sources 条件、post-action、constraint、tags。结果分为 error、warning、suggestion 三级,每条 error/warning 都要求给出具体修复值或编辑指令。

使用方式:提供 template.json 路径或含 .template.config/template.json 的模板目录。先解析 JSON,解析失败则只报告行列与最小修正片段并停止;解析成功后再跑全部规则。输出以一行结论开头(❌ 未就绪 / ⚠️ 可发布但有警告 / ✅ 可发布),随后一张按 error→warning→suggestion 排序的发现表,最后给出总数。

适用场景:用户要求检查或校验 template.json;模板安装后不显示;发布前审查模板;自定义模板行为异常。

限制:不用于查找或使用现有模板、创建项目、从现有项目创建模板(分别路由到 template-discovery、template-instantiation、template-authoring)。shortName 保留子命令集合应以本机 dotnet new --help 的 Commands 段为准,不硬编码。JSON 解析失败时不得继续做语义校验。