.NET NuGet包升级工具 - 自动检测破坏性变更与迁移指南

ln-822-nuget-upgrader by levnikolaevich/claude-code-skills

77 周安装量

253 GitHub Stars

安装命令

npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-822-nuget-upgrader

🇨🇳中文介绍

Paths: File paths (shared/, references/, ../ln-*) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root. If shared/ is missing, fetch files via WebFetch from https://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path}.

ln-822-nuget-upgrader

类型: L3 工作者 类别: 8XX 优化 父级: ln-820-dependency-optimization-coordinator

升级 .NET NuGet 包，具备自动破坏性变更检测和迁移功能。

概述

方面	详情

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

检查项	必需	缺失时的操作
.csproj 文件	是	阻止升级
.sln 文件	否	改用 csproj 发现方式
Git 干净状态	是	阻止（需要干净的基线用于回滚）

工作树与分支隔离

必读: 加载 shared/references/git_worktree_fallback.md — 使用 ln-822 行。

阶段 1: 查找项目

方法	命令
查找 .csproj	`Get-ChildItem -Recurse -Filter *.csproj`
从解决方案	`dotnet sln list`

阶段 2: 安全审计

检查项	命令
易受攻击的包	`dotnet list package --vulnerable`
过时的包	`dotnet list package --outdated`

严重性	操作
严重	阻止升级，报告
高	警告，继续
中/低	仅记录

阶段 3: 检查过时包

使用 dotnet-outdated

步骤	命令
安装工具	`dotnet tool install --global dotnet-outdated-tool`
检查	`dotnet outdated --output json`

阶段 4: 识别破坏性变更

比较当前与最新主版本
检查 breaking_changes_patterns.md
使用 MCP 工具（见下文）查找迁移指南

常见的破坏性变更

包	破坏性版本	关键变更
Microsoft.EntityFrameworkCore	8 → 9	查询变更，迁移格式
Serilog.AspNetCore	7 → 8	配置格式
Swashbuckle.AspNetCore	6 → 7	最小 API 支持

用于迁移搜索的 MCP 工具

优先级顺序（回退策略）

优先级	工具	使用时机
1	mcp__context7__query-docs	查找库文档的首选
2	mcp__Ref__ref_search_documentation	官方 Microsoft 文档
3	WebSearch	最新信息，社区解决方案

查找库 | mcp__context7__resolve-library-id | libraryName: "EntityFrameworkCore"
查询文档 | mcp__context7__query-docs | query: "EF Core 8 to 9 migration breaking changes"

操作	工具	查询示例
搜索	mcp__Ref__ref_search_documentation	"dotnet EntityFrameworkCore 9 migration guide"
阅读	mcp__Ref__ref_read_url	URL 来自搜索结果

当 Context7/Ref 无结果时使用：

"<package> .NET <version> breaking changes migration"
"<error code> <package> fix"

阶段 5: 应用升级

优先级	包类型
1	SDK/运行时 (Microsoft.NET.Sdk)
2	框架 (Microsoft.AspNetCore.*)
3	EF Core (影响迁移)
4	日志记录 (Serilog.*)
5	其他包

操作	命令
更新特定包	`dotnet add package <name> --version <ver>`
更新所有包	`dotnet outdated --upgrade`

阶段 6: 还原与构建

步骤	命令
还原	`dotnet restore`
构建	`dotnet build --configuration Release`
测试	`dotnet test`

从错误中识别失败的包
在 Context7/Ref 中搜索迁移指南
如果无法解决：回滚该包，继续

阶段 7: 报告结果

字段	描述
solution	解决方案路径
projects[]	更新的项目
duration	总耗时
upgrades[]	应用的升级
buildVerification	通过或失败
testResults	X 通过，Y 失败

Options:
  # Upgrade scope
  upgradeType: major          # major | minor | patch

  # Security
  auditLevel: high
  minimumReleaseAge: 14

  # .NET specific
  includePrerelease: false
  targetFramework: net10.0

  # Verification
  runTests: true
  runBuild: true

错误	原因	解决方案
CS0246	缺少类型	搜索替代 API
NU1605	检测到降级	检查包约束
构建失败	破坏性变更	通过 Context7 应用迁移

所有 .csproj 文件已发现（通过解决方案或递归扫描）
安全审计完成 (dotnet list package --vulnerable)
通过 dotnet-outdated 识别出过时的包
通过 breaking_changes_patterns.md 和 MCP 工具检测到破坏性变更
按优先级顺序应用升级 (SDK > 框架 > EF Core > 其他)
dotnet restore, dotnet build, dotnet test 全部通过
返回报告，包含更新的项目、应用的升级以及构建/测试状态

版本: 1.1.0 最后更新: 2026-01-10

🇺🇸English

Paths: File paths (shared/, references/, ../ln-*) are relative to skills repo root. If not found at CWD, locate this SKILL.md directory and go up one level for repo root. If shared/ is missing, fetch files via WebFetch from https://raw.githubusercontent.com/levnikolaevich/claude-code-skills/master/skills/{path}.

ln-822-nuget-upgrader

Type: L3 Worker Category: 8XX Optimization Parent: ln-820-dependency-optimization-coordinator

Upgrades .NET NuGet packages with automatic breaking change detection and migration.

Overview

Aspect	Details
Input	Solution/project path
Output	Updated .csproj files, migration report
Supports	.NET 6, 7, 8, 9, 10

Workflow

Phases: Pre-flight → Find Projects → Security Audit → Check Outdated → Identify Breaking → Apply Upgrades → Restore & Build → Report

Phase 0: Pre-flight Checks

Check	Required	Action if Missing
.csproj file(s)	Yes	Block upgrade
.sln file	No	Use csproj discovery instead
Git clean state	Yes	Block (need clean baseline for revert)

Workers assume coordinator (ln-820) already verified git state and created backup.

Worktree & Branch Isolation

MANDATORY READ: Load shared/references/git_worktree_fallback.md — use ln-822 row.

Phase 1: Find Projects

Discovery Methods

Method	Command
Find .csproj	`Get-ChildItem -Recurse -Filter *.csproj`
From solution	`dotnet sln list`

Phase 2: Security Audit

Commands

Check	Command
Vulnerable packages	`dotnet list package --vulnerable`
Outdated packages	`dotnet list package --outdated`

Actions

Severity	Action
Critical	Block upgrade, report
High	Warn, continue
Moderate/Low	Log only

Phase 3: Check Outdated

Using dotnet-outdated

Step	Command
Install tool	`dotnet tool install --global dotnet-outdated-tool`
Check	`dotnet outdated --output json`

Phase 4: Identify Breaking Changes

Detection

Compare current vs latest major versions
Check breaking_changes_patterns.md
Use MCP tools (see below) for migration guides

Common Breaking Changes

Package	Breaking Version	Key Changes
Microsoft.EntityFrameworkCore	8 → 9	Query changes, migration format
Serilog.AspNetCore	7 → 8	Configuration format
Swashbuckle.AspNetCore	6 → 7	Minimal API support

MCP Tools for Migration Search

Priority Order (Fallback Strategy)

Priority	Tool	When to Use
1	mcp__context7__query-docs	First choice for library docs
2	mcp__Ref__ref_search_documentation	Official Microsoft docs
3	WebSearch	Latest info, community solutions

Context7 Usage

Step	Tool	Parameters
1. Find library	mcp__context7__resolve-library-id	libraryName: "EntityFrameworkCore"
2. Query docs	mcp__context7__query-docs	query: "EF Core 8 to 9 migration breaking changes"

MCP Ref Usage

Action	Tool	Query Example
Search	mcp__Ref__ref_search_documentation	"dotnet EntityFrameworkCore 9 migration guide"
Read	mcp__Ref__ref_read_url	URL from search results

WebSearch Fallback

Use when Context7/Ref return no results:

"<package> .NET <version> breaking changes migration"
"<error code> <package> fix"

Phase 5: Apply Upgrades

Priority Order

Priority	Package Type
1	SDK/Runtime (Microsoft.NET.Sdk)
2	Framework (Microsoft.AspNetCore.*)
3	EF Core (affects migrations)
4	Logging (Serilog.*)
5	Other packages

Commands

Action	Command
Update specific	`dotnet add package <name> --version <ver>`
Update all	`dotnet outdated --upgrade`

Phase 6: Restore & Build

Commands

Step	Command
Restore	`dotnet restore`
Build	`dotnet build --configuration Release`
Test	`dotnet test`

On Failure

Identify failing package from error
Search Context7/Ref for migration guide
If unresolved: rollback package, continue

Phase 7: Report Results

Report Schema

Field	Description
solution	Solution path
projects[]	Updated projects
duration	Total time
upgrades[]	Applied upgrades
buildVerification	PASSED or FAILED
testResults	X passed, Y failed

Configuration

Options:
  # Upgrade scope
  upgradeType: major          # major | minor | patch

  # Security
  auditLevel: high
  minimumReleaseAge: 14

  # .NET specific
  includePrerelease: false
  targetFramework: net10.0

  # Verification
  runTests: true
  runBuild: true

Error Handling

Error	Cause	Solution
CS0246	Missing type	Search for replacement API
NU1605	Downgrade detected	Check package constraints
Build fail	Breaking change	Apply migration via Context7

References

Definition of Done

All .csproj files discovered (via solution or recursive scan)
Security audit completed (dotnet list package --vulnerable)
Outdated packages identified via dotnet-outdated
Breaking changes detected via breaking_changes_patterns.md and MCP tools
Upgrades applied in priority order (SDK > Framework > EF Core > other)
dotnet restore, dotnet build, dotnet test all pass
Report returned with projects updated, upgrades applied, and build/test status

Version: 1.1.0 Last Updated: 2026-01-10

Weekly Installs

Repository

levnikolaevich/…e-skills

GitHub Stars

253

First Seen

Mar 8, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

cursor73

claude-code71

github-copilot70

codex70

kimi-cli70

opencode70

.NET NuGet包升级工具 - 自动检测破坏性变更与迁移指南

🇨🇳中文介绍

ln-822-nuget-upgrader

概述

相关 Skills

工作流程

阶段 0: 预检

工作树与分支隔离

阶段 1: 查找项目

发现方法

阶段 2: 安全审计

命令

操作

阶段 3: 检查过时包

使用 dotnet-outdated

阶段 4: 识别破坏性变更

检测

常见的破坏性变更

用于迁移搜索的 MCP 工具

优先级顺序（回退策略）

Context7 用法

MCP Ref 用法

WebSearch 回退

阶段 5: 应用升级

优先级顺序

命令

阶段 6: 还原与构建

命令

失败处理

阶段 7: 报告结果

报告模式

配置

错误处理

参考资料

完成定义

🇺🇸English

ln-822-nuget-upgrader

Overview

Workflow

Phase 0: Pre-flight Checks

Worktree & Branch Isolation

Phase 1: Find Projects

Discovery Methods

Phase 2: Security Audit

Commands

Actions

Phase 3: Check Outdated

Using dotnet-outdated

Phase 4: Identify Breaking Changes

Detection

Common Breaking Changes

MCP Tools for Migration Search

Priority Order (Fallback Strategy)

Context7 Usage

MCP Ref Usage

WebSearch Fallback

Phase 5: Apply Upgrades

Priority Order

Commands

Phase 6: Restore & Build

Commands

On Failure

Phase 7: Report Results

Report Schema

Configuration

Error Handling

References

Definition of Done

最新 Skills