用 dotnet new 创建 .NET…

在已有仓库中创建新的 .NET 项目/解决方案时，让新项目自动匹配现有 CPM 与目标框架，并正确组合多项目。

适用场景

解决思路

1. 若用户给出自然语言描述，先映射到模板短名（参考 template-discovery 的关键词表）；若已给出模板名则直接使用。
2. 用 `dotnet new <template> --help` 查看用户未指定参数的可用值、默认值和类型。
3. 当用户选择的某个参数隐含了未设置的关联参数取值时，调用 `template-smart-defaults` 技能补齐空缺（例如 native AOT 隐含较新的支持 AOT 的目标框架；非 None 的 `--auth` 意味着必须保留 HTTPS，不要加 `--no-https`；`--use-controllers` 排除 minimal API 选项）；smart defaults 只填空缺，绝不覆盖用户显式设置的值。
4. 创建前分析工作区：检查是否存在 `Directory.Packages.props`（CPM 是否启用）、现有 `.csproj` 使用的目标框架、是否有 `global.json` 固定 SDK。
5. 把发现的工作区目标框架当作显式选择，通过 `--framework` 传入，使其不被 smart-defaults 覆盖；仅当它与所请求功能不兼容时才偏离，并向用户指出冲突。
6. 用 `dotnet new <template> --dry-run` 预览将创建的文件，确认后再继续。
7. 用 `dotnet new` 加模板名和全部参数创建项目，例如 `dotnet new webapi --name MyApi --output ./src/MyApi --framework net10.0 --auth Individual`。
8. 运行前输出一行紧凑决策说明：`Creating <template> at <path>; framework=<value> (<user|workspace|template>); CPM=<on|off>.`。
9. 按状态顺序串行执行命令：inspect、dry-run、create、build；绝不并行执行 create 和 build，否则 build 先于 create 会产生假失败。
10. 不要预测生成的目标框架；若用户和工作区都未提供，查看 `dotnet new <template> --help`，选一个受支持的值（通常是其文档默认值）显式传入，然后确认生成的 `.csproj`；不要宣布未经模板当前选项验证的中间框架猜测。
11. 创建后适配 CPM 并刷新过期版本：先从目标目录向上查找 `Directory.Packages.props` 以检测 CPM。
12. CPM 启用且模板支持 `--no-restore` 时，创建时传入该选项，先完成包集中化再还原。
13. 对每个生成的 `<PackageReference Include="X" Version="Y" />`，移除 `Version` 属性，只留 `<PackageReference Include="X" />`。
14. 在 `Directory.Packages.props` 中添加或合并 `<PackageVersion Include="X" Version="Y" />`，保留无关的既有条目。
15. 可选地刷新模板默认的过期版本：默认保留模板版本（最利于可复现和受控升级）；仅当用户要求时刷新，且优先用工具驱动流程——运行 `dotnet list package --outdated` 并在改动前与用户确认；除非用户明确同意更大跨度，否则升级限制在同一 major（或 major/minor）内；查询包的最新稳定版本时，可用该包 ID 的 NuGet V3 flat-container `index.json` 端点列出已发布版本，除非用户要求否则绝不选预发布版。
16. 运行一次 `dotnet build` 以还原并确认集中化/刷新后的版本可解析。
17. 多项目组合时按顺序创建并连接：`dotnet new webapi --name MyApi --output ./src/MyApi`、`dotnet new xunit --name MyApi.Tests --output ./tests/MyApi.Tests`、`dotnet add ./tests/MyApi.Tests reference ./src/MyApi`、`dotnet sln add ./src/MyApi ./tests/MyApi.Tests`。
18. 模板包管理：`dotnet new install Microsoft.DotNet.Web.ProjectTemplates.10.0` 与 `dotnet new uninstall Microsoft.DotNet.Web.ProjectTemplates.10.0`。
19. 用户明确要求 `.sln` 时：查看 `dotnet new sln --help`，支持则传 `--format sln`，否则使用旧 SDK 默认的 `.sln` 输出。
20. 创建后验证：运行 `dotnet build` 确认可构建；对 `console` 等可运行模板，在请求简单且无需外部服务时运行生成的程序并报告实际输出，而不只是构建成功；若加入解决方案，在解决方案级别运行 `dotnet build` 验证；若适配了 CPM，确认 `Directory.Packages.props` 含新条目。
21. 常见陷阱处理：创建前未检查 CPM 会导致内联版本冲突，创建后需把版本移入 `Directory.Packages.props` 并从 `.csproj` 移除；不要让模板在适配 CPM 前还原失败，先检测 CPM 并用 `--no-restore`；模板支持多 TFM 时始终指定 `--framework` 以免默认到旧版本；创建后用 `dotnet sln add` 把项目加入解决方案；创建后始终运行 `dotnet build` 以尽早发现缺失依赖或参数问题。

适用边界 · 注意事项

• 用户是在搜索模板（用 template-discovery）或需要模板的详细并排比较（用 template-comparison）时。
• 用户想编写自定义模板（用 template-authoring）时。
• 用户想向已有项目添加 NuGet 包（直接用 `dotnet add package`）或修改已有项目时。