用途:帮助智能体为给定任务找到合适的 dotnet new 模板,并检查其参数与输出结构。适用于用户询问“有哪些模板”“我需要一个带认证的 Web API”,或在创建项目前想了解模板参数与产物。不适用于创建项目、编写自定义模板、详细并排比较、智能默认值或构建排错,这些应转交对应技能。
主要能力:把自然语言意图映射为模板短名(如 webapi、console、worker、classlib、maui、xunit 等)和参数(如 --auth、--use-controllers、--aot、--framework);用 dotnet new search 在本地与 NuGet.org 搜索;用 dotnet new list 查看已安装模板;用 dotnet new <template> --help 查看参数名、类型、默认值与允许值;用 dotnet new <template> --dry-run 预览将创建的文件与目录。
使用方式:推荐类请求先按意图映射给出候选,再执行检查;明确要求检查已安装选项、精确参数或 dry-run 输出时,先运行对应命令。命令需顺序执行,模板引擎使用全局互斥锁,并发调用可能产生 mutex/persistence 错误;失败可重试一次,仍失败则回退到意图映射并说明参数未经 CLI 确认。最终回答应先给出可直接复制运行的命令,再补充关键参数、预期产物与前置条件。
限制:部分短名(maui、winui3、aspire、func、orleans 等)通常需要安装工作负载或额外模板包,若不在 dotnet new list 中应改用 list/search 查找提供方。参数名因模板而异,只能引用当前 --help 实际出现的选项,不得凭记忆编造。若用户要求不创建文件,所有创建命令必须带 --dry-run。dry-run 失败时只能给出代表性结构并标注未经确认。