المهارات perigon-backend
⚙️

perigon-backend

آمن 🌐 الوصول إلى الشبكة📁 الوصول إلى نظام الملفات

Aplicar convenções de backend ASP.NET Core

Esta skill fornece convenções padronizadas para construção de serviços de backend ASP.NET Core. Abrange padrões de arquitetura, design de entidades, operações de banco de dados, padrões de manager, mapeamento de DTOs e melhores práticas de controllers para bases de código consistentes e sustentáveis.

يدعم: Claude Codex Code(CC)
📊 69 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "perigon-backend". Create a User entity with email, name, and role enum following Perigon conventions

النتيجة المتوقعة:

  • Entidade herda EntityBase com Id, CreatedAt, UpdatedAt, IsDeleted
  • ID Guid v7 gerado pelo cliente configurado
  • Email e Name com atributos de comprimento máximo
  • Enum Role com atributo [Description]
  • DateTimeOffset adequado para timestamps

استخدام "perigon-backend". Create a REST controller for Product following Perigon conventions

النتيجة المتوقعة:

  • Controller herda de RestControllerBase
  • Endpoints: GetDetailAsync, FilterAsync, AddAsync, UpdateAsync, DeleteAsync
  • Tipos de retorno ActionResult<T> para todos os métodos
  • Respostas Problem/NotFound para tratamento de erros
  • Lógica de negócio delegada ao ProductManager

استخدام "perigon-backend". How should I configure decimal properties in EF Core?

النتيجة المتوقعة:

  • Definir precisão para (10,2) para valores decimais típicos
  • Usar (18,6) para moeda ou cálculos de alta precisão
  • Sempre configurar no método OnModelCreating
  • Evitar decimal padrão que pode causar problemas de precisão

التدقيق الأمني

آمن
v5 • 1/16/2026

This skill contains only markdown documentation for ASP.NET Core + EF Core + Aspire development conventions. No executable code, file system access, network operations, or external commands exist. All 29 static findings are false positives triggered by benign documentation text such as Git hashes, version numbers, and software architecture terminology.

2
الملفات التي تم فحصها
197
الأسطر التي تم تحليلها
2
النتائج
5
إجمالي عمليات التدقيق

عوامل الخطر

🌐 الوصول إلى الشبكة (1)
skill-report.json:6
📁 الوصول إلى نظام الملفات (1)
skill-report.json:6
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
22
المجتمع
100
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

Impor padrões de código

Aplicar convenções consistentes em uma equipe trabalhando em projetos ASP.NET Core

Estruturar novos serviços

Configurar novos serviços seguindo a arquitetura Definition, Modules, Services

Construir endpoints REST

Criar controllers e managers com separação adequada de responsabilidades

جرّب هذه الموجهات

Nova entidade 
Criar uma nova entidade para [entity name] seguindo convenções Perigon. Deve herdar EntityBase, usar ID Guid v7 gerado pelo cliente, incluir comprimentos máximos adequados para strings e adicionar enums apropriados com atributos [Description].
Manager CRUD 
Implementar a classe Manager para [entity name] seguindo convenções Perigon. Usar ManagerBase, incluir operações FindAsync, ExistAsync, ListAsync, PageListAsync, InsertAsync, UpdateAsync, DeleteAsync, BulkInsertAsync e lançar BusinessException para erros.
REST controller 
Criar um REST controller para [entity name] seguindo convenções Perigon. Herdar de RestControllerBase, usar atributos HTTP apropriados, retornar ActionResult<T>, usar Problem/NotFound para erros e manter lógica de business no manager.
Configuração EF 
Configurar EF Core para [entity name] seguindo convenções Perigon. Usar DbContext adequado, configurar relacionamentos com chaves estrangeiras, definir precisão decimal para (10,2) ou (18,6) e usar AsNoTracking para operações de leitura.

أفضل الممارسات

  • Usar abordagem Code First com <Nullable>enable para segurança de tipos
  • Preferir Queryable com projeções Select ao invés de carregar entidades completas
  • Manter controllers finos - delegar toda lógica de negócio para managers
  • Usar ExecuteInTransactionAsync para operações que requerem atomicidade

تجنب

  • Evitar retornar ActionResult de managers ou acessar HttpContext
  • Não usar listas delimitadas por strings - usar arrays ou JSON ao invés disso
  • Evitar referências entre managers que criam acoplamento forte
  • Não envolver respostas em ApiResponse no nível do controller

الأسئلة المتكررة

Quais bancos de dados são suportados?
SQL Server (comercial) e PostgreSQL são os bancos de dados primários. Outros provedores EF Core podem funcionar mas não são cobertos.
Qual é o tamanho máximo do projeto?
Sem limites rígidos. As convenções escalam de APIs pequenas a backends enterprise grandes com múltiplos contextos delimitados.
Como isso se integra com código existente?
Projetado para projetos de template Perigon. Projetos ASP.NET Core existentes podem adotar convenções seletivamente.
Meus dados estão seguros com esta skill?
Sim. Esta skill fornece apenas convenções baseadas em texto. Não acessa arquivos, executa código ou transmite dados.
Por que meu código não está sendo gerado?
Esta skill fornece convenções e diretrizes. Instrui a IA sobre como escrever código - não gera código por si mesma.
Como isso difere de outras skills .NET?
Perigon foca em arquitetura específica (Definition, Modules, Services), padrões EF Core e integração Aspire com convenções estritas.

تفاصيل المطور

المؤلف

AterDev

الترخيص

MIT

المستودع

https://github.com/AterDev/Perigon.template/tree/main/ApiStandard/.github/skills/perigon-backend

مرجع

main

بنية الملفات

📄 SKILL.md