Навыки perigon-agent
📦

perigon-agent

Низкий риск 🌐 Доступ к сети📁 Доступ к файловой системе

Применить соглашения проекта Perigon

Генераторы кода AI не имеют специфичного для проекта контекста. Этот навык предоставляет соглашения Perigon, чтобы агенты следовали правильной структуре каталогов, шаблонам именования и стандартам кодирования при генерации кода.

Поддерживает: Claude Codex Code(CC)
⚠️ 68 Плохо
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «perigon-agent». Сгенерировать новую API конечную точку для управления пользовательскими настройками

Ожидаемый результат:

Я создам конечную точку UserPreferences в соответствии с соглашениями Perigon:

1. Сущность: src/Definition/Share/UserPreference.cs
2. Конфигурация EF: src/Definition/Entity/UserPreferenceConfiguration.cs
3. DTO: src/Modules/UserPreferences/Models/
4. Менеджер: src/Modules/UserPreferences/Managers/UserPreferenceManager.cs
5. Контроллер: src/Services/UserApi/Controllers/UserPreferencesController.cs

Контроллер будет использовать шаблон ManagerBase, возвращать RESTful ответы и обрабатывать ошибки с помощью BusinessException/Problem details.

Использование «perigon-agent». Куда мне поместить новый сервис аутентификации в приложении Angular?

Ожидаемый результат:

Для Angular frontend разместите сервисы, связанные с аутентификацией, в src/ClientApp/WebApp/app/services/. Настройте маршруты, требующие аутентификацию, в guards и обновите соответственно app/app.routes.ts. Храните любые сообщения аутентификации i18n в 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)
skill-report.json:6 SKILL.md:12
📁 Доступ к файловой системе (1)
skill-report.json:6
Проверено: claude Посмотреть историю аудитов →

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
30
Сообщество
90
Безопасность
83
Соответствие спецификации

Что вы можете построить

Онбординг новых разработчиков

Когда разработчику или AI-агенту необходимо понять структуру проекта Perigon перед написанием или изменением кода, этот навык обеспечивает правильное размещение и именование файлов.

Проекты генерации кода

При использовании Claude, Codex или Claude Code для генерации функций для backend или frontend Perigon, этот навык обеспечивает соответствие выходных данных соглашениям проекта.

Обзоры согласованности архитектуры

При проверке сгенерированного AI кода для проектов Perigon, этот навык служит справочником для проверки соблюдения шаблона ManagerBase, обработки ошибок и стандартов RESTful.

Попробуйте эти промпты

Базовый запрос на кодирование Perigon 
Создайте новую RESTful API конечную точку для {entity_name} в проекте Perigon. Поместите контроллер в правильную папку Services, используйте шаблон ManagerBase и следуйте соглашениям проекта по обработке ошибок.
Разработка backend модуля 
Сгенерируйте полный модуль для {module_name}, включая определение сущности, конфигурацию EF, DTO, класс менеджера и контроллер. Следуйте шаблону Code First EF Perigon, используйте Guid v7 для IDs и применяйте select проекции вместо тяжелых операторов Include.
Реализация функциональности frontend 
Создайте новую функциональность Angular с конфигурацией маршрутов в app.routes.ts, связанным сервисом и всеми необходимыми общими компонентами. Следуйте соглашениям frontend Perigon и интегрируйтесь с существующими ресурсами i18n.
Проверка соглашений 
Проверьте следующий код на соответствие соглашениям Perigon: проверьте структуру каталогов, соглашения об именах, использование ManagerBase, шаблоны обработки ошибок и дизайн RESTful API. Перечислите все найденные нарушения.

Лучшие практики

  • Всегда проверяйте .github/copilot-instructions.md на глобальные правила перед генерацией кода в проектах Perigon
  • Запрашивайте детали сущности и модуля, когда они неясны, вместо того чтобы делать предположения о структуре
  • Предпочитайте select проекции операторам Include для оптимизации производительности запросов

Избегать

  • Не предполагайте структуру проекта без консультации с соглашениями этого навыка
  • Избегайте автоматического запуска сборок или миграций; ждите явных запросов
  • Не создавайте классы-обёртки ApiResponse; возвращайте чистые RESTful ответы

Часто задаваемые вопросы

Какова структура проекта Perigon?
Perigon следует модульной архитектуре с определениями в src/Definition, менеджерами и DTO в src/Modules/{Mod}/, контроллерами в src/Services/*/Controllers и хост-приложением в src/AppHost. Frontend представляет собой приложение Angular в src/ClientApp/WebApp.
Как найти глобальные инструкции copilot?
Глобальные правила для AI-агентов находятся в .github/copilot-instructions.md в корне репозитория. Эти правила подчёркивают приоритет точности, избегание сборок без запроса и проверку диагностики.
Какие соглашения об именах использует Perigon?
Perigon использует Guid v7 для генерации ID, следует стандартам именования C# для классов и методов и применяет шаблон ManagerBase для бизнес-логики. Контроллеры должны следовать соглашениям именования RESTful.
Куда помещать ссылки на документацию?
Ключевая документация по соглашениям Perigon доступна по адресу https://dusi.dev/docs/Perigon/en-US/10.0/, охватывающая соглашения по разработке, шаблоны бизнес-логики, проектирование API и шаблоны доступа к базе данных.
Как следует обрабатывать ошибки в Perigon?
Используйте BusinessException для доменных ошибок и ProblemDetails для HTTP ответов об ошибках. Избегайте перекрёстных вызовов менеджеров и не оборачивайте ответы в контейнеры ApiResponse.
Могу ли я использовать этот навык с проектами, отличными от Perigon?
Нет. Этот навык специально предоставляет соглашения только для проектов Perigon. Использование этих соглашений с другими кодовыми базами приведёт к неправильному размещению и именованию файлов.

Сведения для разработчиков

Автор

AterDev

Лицензия

MIT

Репозиторий

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

Ссылка

main

Структура файлов

📄 SKILL.md