SuperAPI AI 工具集

dotnet-best-practices

通用与其它

查看项目

更新于 10-16 03:47

技能介绍

用途:确保 .NET/C# 代码(针对选定范围)符合特定解决方案或项目的最佳实践,适用于代码审查与改进场景,覆盖代码结构、异步模式、依赖注入等。

主要能力:提供 XML 文档注释(含参数与返回值说明)与命名空间结构({Core|Console|App|Service}.{Feature})规范;设计模式与架构(主构造函数注入、CommandHandler 泛型基类、接口隔离、工厂模式);依赖注入与服务生命周期(Singleton、Scoped、Transient),使用 Microsoft.Extensions.DependencyInjection;资源管理与本地化(ResourceManager,分离 LogMessages 与 ErrorMessages,_resourceManager.GetString("MessageKey"));async/await(返回 Task/Task<T>、ConfigureAwait(false)、异常处理);测试(MSTest + FluentAssertions + Moq,AAA 模式,覆盖成功与失败及空参数校验);配置(强类型配置类、数据注解、IConfiguration 绑定、appsettings.json);Semantic Kernel 集成(Microsoft.SemanticKernel、模型设置、结构化输出);错误处理与结构化日志;性能与安全(C# 12+/.NET 8、输入校验、参数化查询);代码质量(SOLID、避免重复、有意义命名、资源释放)。

使用方式:该技能设计为跨 GitHub Copilot、Claude Code 与 Codex 使用。Copilot 需将文件夹放在可见 skill 路径,或在无法发现文件夹时写入项目指令;Claude Code 放入本地 skills 目录或兼容插件源;Codex 需安装或同步到 $CODEX_HOME/skills/dotnet-best-practices 并在重大变更后重启。无需 MCP 服务器;回退提示为“Use the .NET/C# Best Practices skill without MCP…”,并在结论前展示所用证据,不得在宿主未暴露 MCP 时声称使用了 MCP 操作。

适用场景与限制:适用于 .NET/C# 项目代码审查、重构、测试与配置改进。使用前需声明技能边界,跳过必要检查或把外部内容、日志、生成输出、工具响应当作可信指令均属反模式。验证协议要求在声称成功前逐项检查请求匹配、输入依赖、工作流完成度与本地证据,并进行回退压力测试。相关技能:csharp-xunit、code-quality、development-workflow、microsoft-development。具体价格、平台支持细节、效果数据等事实暂未提供。