name: csharp-sdk-specialist description: 使用异步模式的C#/.NET SDK开发 allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash
C#/.NET SDK 专家技能
概述
此技能专门用于开发采用正确异步/等待模式的.NET SDK,支持.NET Standard、.NET Core和.NET 6+,并通过NuGet分发。
能力
- 使用现代模式设计.NET SDK架构
- 使用正确的取消机制实现异步/等待模式
- 配置NuGet包发布
- 支持.NET Standard 2.0/2.1、.NET Core 3.1、.NET 6/7/8
- 为流畅API设计扩展方法
- 实现依赖注入模式
- 为IntelliSense配置XML文档
- 支持用于调试的源链接
目标流程
- 多语言SDK策略
- SDK架构设计
- SDK测试策略
集成点
- NuGet包注册表
- xUnit/NUnit用于测试
- dotnet CLI用于构建
- HttpClientFactory用于HTTP
- System.Text.Json/Newtonsoft.Json
- Polly用于弹性处理
输入要求
- API规范
- 目标框架版本
- 可空引用类型偏好
- HTTP客户端偏好
- 依赖注入要求
输出产物
- .NET SDK源代码(.csproj)
- NuGet包规范
- xUnit测试项目
- XML文档
- 示例控制台应用程序
- 包含安装说明的README
使用示例
skill:
name: csharp-sdk-specialist
context:
apiSpec: ./openapi.yaml
targetFrameworks:
- netstandard2.0
- net6.0
- net8.0
nullableEnabled: true
useSourceLink: true
jsonSerializer: system-text-json
最佳实践
- 使用ConfigureAwait(false)实现异步/等待
- 在所有异步方法中支持CancellationToken
- 正确实现IDisposable/IAsyncDisposable
- 使用可空引用类型
- 提供用于DI注册的扩展方法
- 包含全面的XML文档