ln-822-nuget-upgrader（ln 822 nuget 升级器）

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

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

Overview

Workflow

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

Phase 0: Pre-flight Checks

Runtime Coordination

Managed runs receive deterministic runId and exact summaryArtifactPath from ln-820. Standalone runs remain supported; if runtime arguments are omitted, generate a standalone run-scoped artifact before returning.

Phase 1: Find Projects

Phase 2: Security Audit

Actions:

Phase 3: Check Outdated

Phase 4: Identify Breaking Changes

Detection flow:

1. Compare current vs latest major versions.
2. Check breaking_changes_patterns.md.
3. Use MCP tools for migration guides before changing code.

Common examples:

MCP Tools for Migration Search

Use the tool chain to confirm migrations before applying them.

Phase 5: Apply Upgrades

Priority order:

1. SDK or runtime packages
2. framework packages
3. EF Core
4. logging packages
5. everything else

Phase 6: Restore and Build

On failure:

1. Identify the failing package.
2. Search Context7 or Ref for the migration guide.
3. If unresolved, rollback that package and continue.

Phase 7: Report Results

Configuration

Options:
  upgradeType: major          # major | minor | patch
  auditLevel: high
  minimumReleaseAge: 14
  includePrerelease: false
  targetFramework: net10.0
  runTests: true
  runBuild: true

Error Handling

References

• breaking_changes_patterns.md
• dotnet_version_matrix.md

Runtime Summary Artifact

MANDATORY READ: Load shared/references/coordinator_summary_contract.md

Emit a dependency-worker summary envelope.

Managed mode:

• ln-820 passes deterministic runId and exact summaryArtifactPath
• write the summary to the provided summaryArtifactPath

Standalone mode:

• omit runId and summaryArtifactPath
• write .hex-skills/runtime-artifacts/runs/{run_id}/dependency-worker/ln-822--{identifier}.json

Monitor (2.1.98+): For restore/build/test commands expected >30s, use Monitor. Fallback: Bash(run_in_background=true).

Definition of Done

• All target .csproj files discovered
• Security audit completed for NuGet dependencies
• Outdated packages identified
• Breaking changes checked via patterns plus current docs
• Upgrades applied in a safe order with rollback on failure
• dotnet restore, dotnet build, and required tests succeed
• dependency-worker summary artifact written to the managed or standalone path

Version: 1.1.0 Last Updated: 2026-01-10