1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | dotnet-upgrade-github-awesome-copilot |
| 作者/维护者 | GitHub(github/awesome-copilot 合集);该提示词由社区贡献者 kshashank57 于 2025-10-21 首次提交(账号 2019 年注册) |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/dotnet-upgrade |
| 许可证 | MIT(合集仓库,GitHub API) |
| GitHub Stars / Forks | 合集整体 39,802 / 5,078(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 技能自身热度 | skills.sh 安装量约 11.2K(网页抓取) |
| 最新版本 | 无独立版本号;最近一次提交 2026-02-24 |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill dotnet-upgrade |
2. 功能介绍与亮点
这是一份纯提示词 skill(单个 SKILL.md,约 7 KB),把一次 .NET 框架升级拆成约 40 条可直接下达给 agent 的提示词,按升级的先后顺序分成八个阶段:
- 项目盘点:识别解决方案里的 .NET Framework / Core / Standard 项目,读各
.csproj的TargetFramework,找出仍用packages.config的旧项目。 - 升级策略与顺序:从依赖最少的类库升到最依赖别人的 API / Azure Function,带回滚检查点,对比 Upgrade Assistant 与手工升级。
- 目标框架与代码现代化:选定
net8.0等目标,指出WebHostBuilder→HostBuilder、Startup.cs→Program.cs这类需改写的写法。 - NuGet 与 CI/CD:不兼容包与传递依赖冲突分析;
UseDotNet@2、NuGetToolInstaller等流水线任务的 SDK 版本更新。 - 验证、破坏性变更、版本控制与文档:回归测试重点、已废弃 API 检测、分支与 PR 结构、发布说明模板。
3. 适用场景
分类:工程效率与代码质量。
- 把老的 .NET Framework 4.x 解决方案升级到 .NET 8,需要一份不遗漏的升级清单
- 多项目解决方案要排升级顺序、评估第三方包是否支持新框架
- 团队要为升级写 PR 规范、回归测试计划和发布说明
受益人群:维护存量 .NET 项目、第一次做大版本升级的初中级开发者。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(name + description 前置信息),放入 skills 目录即可;正文是提示词清单,需在对话里点名要用哪一阶段 |
| Codex | 需适配 | 同为 Agent Skills 格式,需手动引用或放入其 skills 路径 |
| OpenClaw | 未验证 | 未找到官方兼容说明 |
| Hermes Agent | 未验证 | 未找到官方兼容说明 |
5. 推荐理由
.NET 大版本升级最容易漏的不是改代码,而是顺序、依赖兼容、流水线和回滚。这份 skill 把这些环节排成一条完整的清单,开发者不必自己回忆还漏了哪一步,可以逐阶段让 agent 执行。零依赖、不执行脚本,装好即用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | skills.sh 安装量约 11.2K;出自 GitHub 官方合集;暂无针对该技能的具名第三方评价 |
| 可用性 | 7 | 一条命令安装、覆盖升级全流程;但正文是提示词清单而非分步执行流程,没有示例输出,也不会自行编排阶段,需用户逐段选用;技能文件最近更新为 2026-02 |
| 安全性 | 9 | 纯提示词,无脚本、无联网、无凭据;MIT;GitHub 官方合集 |
安全检查清单:①无 shell 指令(仅提示词中建议使用 Upgrade Assistant、dotnet list package --outdated 等标准工具,由用户批准)②无外联 ③无凭据 ④未发现可疑指令 ⑤GitHub 官方合集、贡献者账号 2019 年注册 ⑥MIT ⑦合集仓库近日仍有提交。第三方审计(Gen Agent Trust Hub / Socket / Snyk)均为通过。
7. 跟同类 Skills 相比的优势
| 方案 | 定位 | 差异 |
|---|---|---|
| 本 skill | .NET 框架升级的全流程提示词清单 | 覆盖盘点、顺序、NuGet、CI/CD、验证、PR 与文档 |
| .NET Upgrade Assistant(微软工具) | 自动改写项目文件与部分代码 | 是执行工具,不做策略、顺序和流程层面的规划;可与本 skill 搭配 |
| 微软官方迁移文档 | 逐版本的破坏性变更说明 | 权威但不成流程,需人工对照;本 skill 帮 agent 把它们落到步骤上 |
| dotnet/skills 中的 dotnet-msbuild 等 | 构建与 MSBuild 诊断 | 针对构建问题,不涉及升级规划 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 其他补充
最初以 VS Code 提示词文件形式贡献,2026-02 与合集其他提示词一并转换为 skill 格式。
10. 安装使用方式
- 执行
npx skills add https://github.com/github/awesome-copilot --skill dotnet-upgrade - 对 agent 说:“用 dotnet-upgrade,先做项目盘点,列出每个项目当前的 TargetFramework 和 packages.config 情况”
- 按阶段逐步推进,每个阶段完成并通过构建与测试后再进入下一阶段
11. 注意事项
- 正文是平铺的提示词清单,不是自动流程,务必让 agent 一次只做一个阶段
- 示例以升级到 .NET 8 为主,升级到更新版本时需自行核对目标框架与废弃 API
- 升级前确保项目有版本控制和可运行的测试,否则回滚检查点无从落实