该技能提供了一套通用的 .NET 开发工作流模式,适用于实现功能、修复 Bug 或重构代码等场景。
用途与流程:整体分为四个阶段。第一阶段理解任务:功能实现需阅读需求或用户故事、识别受影响组件、查找代码库已有模式并规划方案;Bug 修复需复现问题、定位根因、查找相关代码并规划修复;重构需理解现有实现、明确改动范围、确认测试覆盖并规划增量变更。第二阶段实现变更:遵循代码库已有模式(资料以服务类构造函数注入为例说明新代码应与既有模式一致),并强调小步增量修改,每次变更后构建以尽早发现错误、频繁运行相关测试、保持提交聚焦。第三阶段验证变更,给出的必要命令为:dotnet build --no-incremental、dotnet test --no-build、dotnet build /p:TreatWarningsAsErrors=true、dotnet format --verify-no-changes。第四阶段修复问题,按构建错误、测试失败、分析告警分别处理,并可用 dotnet format 自动修复可自动修复的问题。
质量门禁:构建要求 0 错误(阻塞),测试要求 100% 通过(阻塞),关键告警为 0(非阻塞),全部告警少于 10(非阻塞)。
提交前清单:dotnet build 无错误、dotnet test 全部通过、无新的关键分析器告警、代码遵循已有模式、变更聚焦于任务本身。完整验证命令为 dotnet build --no-incremental && dotnet test --no-build && dotnet format --verify-no-changes。
最佳实践:代码组织按字段、构造函数、公共方法、私有方法排序;错误处理使用具体异常与守卫子句(如 ArgumentNullException.ThrowIfNull);异步方法使用 Async 后缀并避免阻塞(不用 .Result);依赖注入提供 AddScoped、AddSingleton、AddTransient 注册方式与构造函数注入示例。更多实现模式参见 patterns.md。
限制:资料未提供该技能的安装方式、收费标准、支持平台或版本要求,暂未提供相关说明。