从现有 .NET 项目创建可复用 dotnet new…

当你需要把已有的 .csproj 项目做成可复用的 dotnet new 模板，或验证/打包自己编写的 template.json 时使用。

适用场景

解决思路

1. 默认把源项目复制到一个专门的 template-source 目录，保持原项目不变；只有当用户明确要求就地修改时才直接改原项目。
2. 在 template-source 目录内创建 .template.config 目录。
3. 生成 template.json，包含 identity（反向 DNS 格式）、name、shortName、sourceName（用于替换的项目名）、classifications 和 tags。
4. 从源 .csproj 逐项保留以下约定并核对：SDK 类型（Microsoft.NET.Sdk、Microsoft.NET.Sdk.Web、Microsoft.NET.Sdk.Worker 等）；Analyzer/包引用的 PrivateAssets、IncludeAssets、ExcludeAssets 元数据；OutputType 及 TreatWarningsAsErrors、Nullable、LangVersion 等关键属性；CPM 参与情况（存在 Directory.Packages.props 时不要写内联 Version）；自定义 build props/targets 与 Directory.Build.props 约定；仓库约定（目录布局、命名、global.json SDK 固定）。
5. 写出针对实际源项目的完整 template.json，不要只给最小 stub；随后输出一份简短的 conventions-preserved 确认表，逐行标明每项源设置是否被保留及方式，故意省略的行标 ⚠️ 并说明原因。
6. 用 template-validation 技能验证生成的 template.json（必填字段、identity 格式、shortName 冲突、参数数据类型、post-actions、constraints、tags）。
7. 检查必填字段 identity、name、shortName 是否存在；检查 shortName 是否与 dotnet new 子命令冲突——从已安装 SDK 的 dotnet new --help 的 Commands: 段读取权威集合，不要硬编码（示例：install、uninstall、update、list、search、details、create）；顶层动词如 build、run、test、publish 不冲突；运行 dotnet new list 确认名称未被占用。
8. 按需细化模板：添加带类型（string、bool、choice）、默认值和描述的 parameters；用文件类型对应的合法语法添加条件内容（XML 中用 XML 注释包裹模板指令，如 <!--#if (database == "SqlServer") --> ... <!--#endif -->，不要用裸 #if 行）；配置 post-actions（解决方案添加、restore、自定义脚本）；设置 constraints 限制支持的 SDK 或工作负载；添加 classifications 和 tags 便于发现。
9. restore post-action 优先使用 primaryOutputs（已知项目路径时），actionId 用 210D431B-A78B-4D2F-B762-4ED3E3EA9025，不要在该 action 上用 executable 等 run-script 字段；若必须用 args.files，其路径匹配的是重命名前的源模板（如 "files": ["**/*.csproj"]），并向用户解释这一区别。
10. 限制到 SDK 宿主时，用 host constraint，其 args 为包含 { "hostname": "dotnetcli" } 的数组，可选 version 限制宿主/CLI 版本；不要用无效 host ID dotnet-cli，也不要用无关的 pattern/value 字段。
11. 限制活动 SDK 版本时，用 sdk-version constraint，args 中放 NuGet 版本/范围字符串；除非模板确实需要，不要用机器特定的精确补丁版本。
12. 保留 CPM：生成的 PackageReference 不带 Version，模板自包含时打包所属的 Directory.Packages.props。
13. 打包模板时，提供完整的 pack 项目文件：<PackageType>Template</PackageType>，模板内容打包到 content/ 下，例如 <Content Include="templates\**\*" Pack="true" PackagePath="content\" />，并设置 IncludeBuildOutput=false、NoWarn 加 NU5128；pack 项目的 TargetFramework 只作用于纯打包项目，不会重定向 templates/ 内的项目，优先选广泛可用的受支持框架。
14. 自包含 CPM 模板中，打包的 Directory.Packages.props 必须含 <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>，每个无版本 PackageReference 都要有匹配的 PackageVersion；props 文件放在预期的生成仓库根，不要在更靠近项目处放重复文件以免改变查找。
15. 创建类请求必须本地测试：dotnet new install ./path/to/template/root；dotnet new mylib --name TestProject --dry-run；dotnet new mylib --name TestProject --output ./test-output；dotnet build ./test-output/TestProject；逐项报告观察结果，仅检查 template.json 不能证明模板可用。
16. 用不同参数值运行 dotnet new <template> --dry-run 验证所有参数组合下条件内容输出正确。
17. 按 Validation 清单核对：template.json 零错误、identity 与 shortName 唯一且有意义、所有参数有描述和合适默认值、可安装/干跑/实例化、生成项目 dotnet build 通过、条件内容各组合正确、XML 模板指令包裹在 XML 注释中且生成项目可解析、host constraints 用 args[].hostname、restore actions 用 primaryOutputs 或 args.files。
18. 避免常见坑：identity 用反向 DNS 且无空格/特殊字符；shortName 不撞 CLI 子命令；每个参数都有 description 和 displayName；用 sourceName 替换项目名并考虑参数化框架版本；设置 classifications（如 ["Web", "API"]）；不要复用其他 constraint 或 post-action 的字段。

适用边界 · 注意事项

• 查找或使用已有模板（应使用 template-discovery 或 template-instantiation）。
• 与模板编写无关的 MSBuild 项目文件问题（应使用 dotnet-msbuild 插件）。
• NuGet 包发布本身（本技能只涉及模板打包结构）。