dotnet-upgrade

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Project Discovery & Assessment

项目发现与评估

name: "Project Classification Analysis" prompt: "Identify all projects in the solution and classify them by type (
```
.NET Framework
```
,
```
.NET Core
```
,
```
.NET Standard
```
). Analyze each
```
.csproj
```
for its current
```
TargetFramework
```
and SDK usage."
- name: "Dependency Compatibility Review" prompt: "Review external and internal dependencies for framework compatibility. Determine the upgrade complexity based on dependency graph depth."
- name: "Legacy Package Detection" prompt: "Identify legacy
```
packages.config
```
  projects needing migration to
```
PackageReference
```
  format."
Upgrade Strategy & Sequencing
- name: "Project Upgrade Ordering" prompt: "Recommend a project upgrade order from least to most dependent components. Suggest how to isolate class library upgrades before API or Azure Function migrations."
- name: "Incremental Strategy Planning" prompt: "Propose an incremental upgrade strategy with rollback checkpoints. Evaluate the use of Upgrade Assistant or manual upgrades based on project structure."
- name: "Progress Tracking Setup" prompt: "Generate an upgrade checklist for tracking build, test, and deployment readiness across all projects."
Framework Targeting & Code Adjustments
- name: "Target Framework Selection" prompt: "Suggest the correct
```
TargetFramework
```
  for each project (e.g.,
```
net8.0
```
  ). Review and update deprecated SDK or build configurations."
- name: "Code Modernization Analysis" prompt: "Identify code patterns needing modernization (e.g.,
```
WebHostBuilder
```
  →
```
HostBuilder
```
  ). Suggest replacements for deprecated .NET APIs and third-party libraries."
- name: "Async Pattern Conversion" prompt: "Recommend conversion of synchronous calls to async where appropriate for improved performance and scalability."
NuGet & Dependency Management
- name: "Package Compatibility Analysis" prompt: "Analyze outdated or incompatible NuGet packages and suggest compatible versions. Identify third-party libraries that lack .NET 8 support and provide migration paths."
- name: "Shared Dependency Strategy" prompt: "Recommend strategies for handling shared dependency upgrades across projects. Evaluate usage of legacy packages and suggest alternatives in Microsoft-supported namespaces."
- name: "Transitive Dependency Review" prompt: "Review transitive dependencies and potential version conflicts after upgrade. Suggest resolution strategies for dependency conflicts."
CI/CD & Build Pipeline Updates
- name: "Pipeline Configuration Analysis" prompt: "Analyze YAML build definitions for SDK version pinning and recommend updates. Suggest modifications for
```
UseDotNet@2
```
  and
```
NuGetToolInstaller
```
  tasks."
- name: "Build Pipeline Modernization" prompt: "Generate updated build pipeline snippets for .NET 8 migration. Recommend validation builds on feature branches before merging to main."
- name: "CI Automation Enhancement" prompt: "Identify opportunities to automate test and build verification in CI pipelines. Suggest strategies for continuous integration validation."
Testing & Validation
- name: "Build Validation Strategy" prompt: "Propose validation checks to ensure the upgraded solution builds and runs successfully. Recommend automated test execution for unit and integration suites post-upgrade."
- name: "Service Integration Verification" prompt: "Generate validation steps to verify logging, telemetry, and service connectivity. Suggest strategies for verifying backward compatibility and runtime behavior."
- name: "Deployment Readiness Check" prompt: "Recommend UAT deployment verification steps before production rollout. Create comprehensive testing scenarios for upgraded components."
Breaking Change Analysis
- name: "API Deprecation Detection" prompt: "Identify deprecated APIs or removed namespaces between target versions. Suggest automated scanning using
```
.NET Upgrade Assistant
```
  and API Analyzer."
- name: "API Replacement Strategy" prompt: "Recommend replacement APIs or libraries for known breaking areas. Review configuration changes such as
```
Startup.cs
```
  →
```
Program.cs
```
  refactoring."
- name: "Regression Testing Focus" prompt: "Suggest regression testing scenarios focused on upgraded API endpoints or services. Create test plans for critical functionality validation."
Version Control & Commit Strategy
- name: "Branching Strategy Planning" prompt: "Recommend branching strategy for safe upgrade with rollback capability. Generate commit templates for partial and complete project upgrades."
- name: "PR Structure Optimization" prompt: "Suggest best practices for creating structured PRs (
```
Upgrade to .NET [Version]
```
  ). Identify tagging strategies for PRs involving breaking changes."
- name: "Code Review Guidelines" prompt: "Recommend peer review focus areas (build, test, and dependency validation). Create checklists for effective upgrade reviews."
Documentation & Communication
- name: "Upgrade Documentation Strategy" prompt: "Suggest how to document each project's framework change in the PR. Propose automated release note generation summarizing upgrades and test results."
- name: "Stakeholder Communication" prompt: "Recommend communicating version upgrades and migration timelines to consumers. Generate documentation templates for dependency updates and validation results."
- name: "Progress Tracking Systems" prompt: "Suggest maintaining an upgrade summary dashboard or markdown checklist. Create templates for tracking upgrade progress across multiple projects."
Tools & Automation
- name: "Upgrade Tool Selection" prompt: "Recommend when and how to use:
```
.NET Upgrade Assistant
```
  ,
```
dotnet list package --outdated
```
  ,
```
dotnet migrate
```
  , and
```
graph.json
```
  dependency visualization."
- name: "Analysis Script Generation" prompt: "Generate scripts or prompts for analyzing dependency graphs before upgrading. Propose AI-assisted prompts for Copilot to identify upgrade issues automatically."
- name: "Multi-Repository Validation" prompt: "Suggest how to validate automation output across multiple repositories. Create standardized validation workflows for enterprise-scale upgrades."
Final Validation & Delivery
- name: "Final Solution Validation" prompt: "Generate validation steps to confirm the final upgraded solution passes all validation checks. Suggest production deployment verification steps post-upgrade."
- name: "Deployment Readiness Confirmation" prompt: "Recommend generating final test results and build artifacts. Create a checklist summarizing completion across projects (builds/tests/deployment)."
- name: "Release Documentation" prompt: "Generate a release note summarizing framework changes and CI/CD updates. Create comprehensive upgrade summary documentation."

name: "项目分类分析" prompt: "识别解决方案中的所有项目，并按类型（
```
.NET Framework
```
、
```
.NET Core
```
、
```
.NET Standard
```
）分类。分析每个
```
.csproj
```
文件的当前
```
TargetFramework
```
和SDK使用情况。"
- name: "依赖兼容性审查" prompt: "审查外部和内部依赖项的框架兼容性。根据依赖图深度确定升级复杂度。"
- name: "遗留包检测" prompt: "识别需要从
```
packages.config
```
  格式迁移到
```
PackageReference
```
  格式的遗留项目。"
升级策略与排序
- name: "项目升级顺序规划" prompt: "建议从依赖最少到依赖最多的组件的项目升级顺序。建议如何在API或Azure Function迁移之前隔离类库升级。"
- name: "增量策略规划" prompt: "提出带有回滚检查点的增量升级策略。根据项目结构评估使用Upgrade Assistant还是手动升级。"
- name: "进度跟踪设置" prompt: "生成升级检查清单，用于跟踪所有项目的构建、测试和部署就绪情况。"
框架目标与代码调整
- name: "目标框架选择" prompt: "为每个项目建议正确的
```
TargetFramework
```
  （例如
```
net8.0
```
  ）。审查并更新已弃用的SDK或构建配置。"
- name: "代码现代化分析" prompt: "识别需要现代化的代码模式（例如
```
WebHostBuilder
```
  →
```
HostBuilder
```
  ）。建议替换已弃用的.NET API和第三方库。"
- name: "异步模式转换" prompt: "建议在合适的情况下将同步调用转换为异步调用，以提升性能和可扩展性。"
NuGet与依赖管理
- name: "包兼容性分析" prompt: "分析过时或不兼容的NuGet包，并建议兼容版本。识别不支持.NET 8的第三方库并提供迁移路径。"
- name: "共享依赖策略" prompt: "建议跨项目处理共享依赖项升级的策略。评估遗留包的使用情况，并建议Microsoft支持的命名空间中的替代方案。"
- name: "传递依赖审查" prompt: "审查升级后的传递依赖项和潜在版本冲突。建议依赖冲突的解决策略。"
CI/CD与构建流水线更新
- name: "流水线配置分析" prompt: "分析YAML构建定义中的SDK版本固定情况并建议更新。建议对
```
UseDotNet@2
```
  和
```
NuGetToolInstaller
```
  任务进行修改。"
- name: "构建流水线现代化" prompt: "生成用于.NET 8迁移的更新后的构建流水线代码片段。建议在合并到主分支之前，在功能分支上进行验证构建。"
- name: "CI自动化增强" prompt: "识别在CI流水线中自动化测试和构建验证的机会。建议持续集成验证策略。"
测试与验证
- name: "构建验证策略" prompt: "提出验证检查，确保升级后的解决方案能够成功构建并运行。建议在升级后自动执行单元测试和集成测试套件。"
- name: "服务集成验证" prompt: "生成验证步骤，以验证日志记录、遥测和服务连接性。建议验证向后兼容性和运行时行为的策略。"
- name: "部署就绪检查" prompt: "建议在生产部署前进行UAT（用户验收测试）部署验证步骤。为升级后的组件创建全面的测试场景。"
破坏性变更分析
- name: "API弃用检测" prompt: "识别目标版本之间已弃用的API或已移除的命名空间。建议使用
```
.NET Upgrade Assistant
```
  和API Analyzer进行自动化扫描。"
- name: "API替换策略" prompt: "建议针对已知破坏性领域的替代API或库。审查配置变更，例如
```
Startup.cs
```
  →
```
Program.cs
```
  重构。"
- name: "回归测试重点" prompt: "建议针对升级后的API端点或服务的回归测试场景。为关键功能验证创建测试计划。"
版本控制与提交策略
- name: "分支策略规划" prompt: "建议具有回滚能力的安全升级分支策略。为部分和完整项目升级生成提交模板。"
- name: "PR结构优化" prompt: "建议创建结构化PR的最佳实践（例如
```
Upgrade to .NET [Version]
```
  ）。识别涉及破坏性变更的PR的标记策略。"
- name: "代码审查指南" prompt: "建议同行审查的重点领域（构建、测试和依赖验证）。创建有效的升级审查检查清单。"
文档与沟通
- name: "升级文档策略" prompt: "建议如何在PR中记录每个项目的框架变更。提出自动生成发布说明的方案，总结升级和测试结果。"
- name: "利益相关者沟通" prompt: "建议向使用者传达版本升级和迁移时间表。为依赖项更新和验证结果生成文档模板。"
- name: "进度跟踪系统" prompt: "建议维护升级汇总仪表板或Markdown检查清单。创建用于跟踪多个项目升级进度的模板。"
工具与自动化
- name: "升级工具选择" prompt: "建议何时以及如何使用：
```
.NET Upgrade Assistant
```
  、
```
dotnet list package --outdated
```
  、
```
dotnet migrate
```
  和
```
graph.json
```
  依赖项可视化工具。"
- name: "分析脚本生成" prompt: "生成用于在升级前分析依赖图的脚本或提示词。提出用于Copilot的AI辅助提示词，以自动识别升级问题。"
- name: "多仓库验证" prompt: "建议如何跨多个仓库验证自动化输出。为企业级升级创建标准化验证工作流。"
最终验证与交付
- name: "最终解决方案验证" prompt: "生成验证步骤，确认最终升级后的解决方案通过所有验证检查。建议升级后的生产部署验证步骤。"
- name: "部署就绪确认" prompt: "建议生成最终测试结果和构建工件。创建总结所有项目完成情况的检查清单（构建/测试/部署）。"
- name: "发布文档" prompt: "生成总结框架变更和CI/CD更新的发布说明。创建全面的升级汇总文档。"

dotnet-upgrade

Original

Translation

Project Discovery & Assessment

项目发现与评估

Upgrade Strategy & Sequencing

Framework Targeting & Code Adjustments

NuGet & Dependency Management

CI/CD & Build Pipeline Updates

Testing & Validation

Breaking Change Analysis

Version Control & Commit Strategy

Documentation & Communication

Tools & Automation

Final Validation & Delivery

升级策略与排序

框架目标与代码调整

NuGet与依赖管理

CI/CD与构建流水线更新

测试与验证

破坏性变更分析

版本控制与提交策略

文档与沟通

工具与自动化

最终验证与交付