Dotnet Best Practices skill

O que ela faz

Confere o trecho de código .NET ou C# que você indicar contra uma lista de boas práticas e ajusta o que não bate. Pede comentário de documentação XML em toda classe, método e propriedade pública, com parâmetros e retorno descritos, e namespaces no formato Core, Console, App ou Service.

Na arquitetura, usa construtor primário pra injeção de dependência, com checagem de nulo, o padrão Command Handler, interfaces com prefixo I e Factory pra objetos complexos. Exige async/await em tudo que acessa disco, rede ou banco, configuração tipada com validação, logs estruturados e mensagens em arquivos de recurso, separadas entre log e erro.

Nos testes, MSTest com FluentAssertions e Moq, no formato Arrange, Act, Assert, cobrindo sucesso, falha e parâmetro nulo. Puxa recursos do C# 12 e do .NET 8 onde cabem, consultas parametrizadas no banco, validação de entrada, princípios SOLID e o Semantic Kernel quando o código usa IA.

Nas palavras de quem fez

Quando usar

• Revisar uma classe C# antes de abrir o pull request
• Documentar um projeto .NET que ficou sem comentário nenhum
• Padronizar injeção de dependência e logs num serviço
• Escrever os testes que faltam com MSTest e Moq

Depois de instalar, é só pedir assim

• Passa a skill dotnet-best-practices no PedidoService.cs e corrige o que estiver fora
• Escreve os testes desse handler com MSTest, FluentAssertions e Moq, incluindo o caso de parâmetro nulo
• Documenta todas as classes públicas desse projeto com comentário XML

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

• Gen Agent Trust HubPassou
• SocketPassou
• SnykPassou

Perguntas