技能 perigon-agent
📦

perigon-agent

低風險 🌐 網路存取📁 檔案系統存取

Aplicar Convenciones del Proyecto Perigon

Los generadores de código con IA carecen de contexto específico del proyecto. Esta habilidad proporciona las convenciones de Perigon para que los agentes sigan la estructura de directorios, patrones de nomenclatura y estándares de codificación correctos al generar código.

支援: Claude Codex Code(CC)
⚠️ 68
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「perigon-agent」。 Generar un nuevo endpoint de API para gestionar preferencias de usuario

預期結果:

Crearé el endpoint UserPreferences siguiendo las convenciones de Perigon:

1. Entity: src/Definition/Share/UserPreference.cs
2. EF Config: src/Definition/Entity/UserPreferenceConfiguration.cs
3. DTOs: src/Modules/UserPreferences/Models/
4. Manager: src/Modules/UserPreferences/Managers/UserPreferenceManager.cs
5. Controller: src/Services/UserApi/Controllers/UserPreferencesController.cs

El controlador usará el patrón ManagerBase, devolverá respuestas RESTful y manejará errores con BusinessException/Problem details.

正在使用「perigon-agent」。 ¿Dónde debo colocar un nuevo servicio de autenticación en la aplicación Angular?

預期結果:

Para el frontend Angular, coloca los servicios relacionados con autenticación en src/ClientApp/WebApp/app/services/. Configura las rutas que requieren autenticación en los guards y actualiza app/app.routes.ts en consecuencia. Almacena cualquier mensaje i18n de autenticación en assets/i18n/.

安全審計

低風險
v6 • 1/21/2026

Static scanner detected URL patterns and file references. Evaluation confirms these are benign: source_url is GitHub metadata, documentation links are standard references, and 'weak cryptographic algorithm' findings are scanner false positives (line numbers exceed file bounds). This is a development conventions guide with no malicious intent.

2
已掃描檔案
252
分析行數
2
發現項
6
審計總數

風險因素

🌐 網路存取 (2)
📁 檔案系統存取 (1)
審計者: claude 查看審計歷史 →

品質評分

38
架構
100
可維護性
87
內容
30
社群
90
安全
83
規範符合性

你能建構什麼

Incorporación de Nuevos Desarrolladores

Cuando un desarrollador o agente de IA necesita comprender el diseño del proyecto Perigon antes de escribir o modificar código, esta habilidad asegura la ubicación y nomenclatura correcta de archivos.

Proyectos de Generación de Código

Al usar Claude, Codex o Claude Code para generar características para un backend o frontend de Perigon, esta habilidad asegura que la salida siga las convenciones del proyecto.

Revisiones de Consistencia de Arquitectura

Al revisar código generado por IA para proyectos Perigon, esta habilidad sirve como referencia para verificar la adherencia al patrón ManagerBase, manejo de errores y estándares RESTful.

試試這些提示

Solicitud Básica de Codificación Perigon
Crear un nuevo endpoint de API RESTful para {entity_name} en el proyecto Perigon. Colocar el controlador en la carpeta Services correcta, usar el patrón ManagerBase y seguir las convenciones de manejo de errores del proyecto.
Desarrollo de Módulo Backend
Generar un módulo completo para {module_name} incluyendo la definición de entidad, configuración EF, DTOs, clase manager y controlador. Seguir el patrón Code First EF de Perigon, usar Guid v7 para IDs y aplicar proyecciones select en lugar de declaraciones Include pesadas.
Implementación de Característica Frontend
Crear una nueva característica Angular con configuración de ruta en app.routes.ts, servicio asociado y cualquier componente compartido necesario. Seguir las convenciones frontend de Perigon e integrar con los assets i18n existentes.
Verificación de Convenciones
Revisar el siguiente código para cumplimiento de convenciones de Perigon: verificar estructura de directorios, convenciones de nomenclatura, uso de ManagerBase, patrones de manejo de errores y diseño de API RESTful. Listar cualquier violación encontrada.

最佳實務

  • Siempre verificar .github/copilot-instructions.md para reglas globales antes de generar código en proyectos Perigon
  • Preguntar por detalles de entidad y módulo cuando no estén claros en lugar de hacer suposiciones sobre la estructura
  • Preferir proyecciones select sobre declaraciones Include para optimizar el rendimiento de consultas

避免

  • No asumir la estructura del proyecto sin consultar las convenciones de esta habilidad
  • Evitar ejecutar builds o migraciones automáticamente; esperar solicitudes explícitas
  • No crear clases wrapper ApiResponse; devolver respuestas RESTful sin procesar en su lugar

常見問題

¿Cuál es la estructura del proyecto Perigon?
Perigon sigue una arquitectura modular con definiciones en src/Definition, managers y DTOs en src/Modules/{Mod}/, controladores en src/Services/*/Controllers y la aplicación host en src/AppHost. El frontend es una aplicación Angular en src/ClientApp/WebApp.
¿Cómo encuentro las instrucciones globales de copilot?
Las reglas globales para agentes de IA están ubicadas en .github/copilot-instructions.md en la raíz del repositorio. Estas reglas enfatizan precisión primero, evitar builds a menos que se solicite y verificar diagnósticos.
¿Qué convenciones de nomenclatura usa Perigon?
Perigon usa Guid v7 para generación de IDs, sigue estándares de nomenclatura de C# para clases y métodos, y aplica el patrón ManagerBase para lógica de negocio. Los controladores deben seguir convenciones de nomenclatura RESTful.
¿Dónde coloco los enlaces de documentación?
La documentación clave para las convenciones de Perigon está disponible en https://dusi.dev/docs/Perigon/en-US/10.0/ cubriendo convenciones de desarrollo, patrones de lógica de negocio, diseño de API y patrones de acceso a base de datos.
¿Cómo deben manejarse los errores en Perigon?
Usar BusinessException para errores de dominio y ProblemDetails para respuestas de error HTTP. Evitar llamadas cruzadas de managers y no envolver respuestas en contenedores ApiResponse genéricos.
¿Puedo usar esta habilidad con proyectos que no sean Perigon?
No. Esta habilidad proporciona específicamente convenciones solo para proyectos Perigon. Usar estas convenciones en otras bases de código resultará en ubicaciones de archivos y patrones de nomenclatura incorrectos.

開發者詳情

檔案結構

📄 SKILL.md