Perigon智能体开发规范指南Skill perigon-agent

Perigon智能体开发规范指南是一份面向Copilot或AI智能体的详细开发指引文档，旨在确保代码生成符合Perigon项目架构与最佳实践。它提供了前后端项目结构地图、关键文档索引、默认行为规范（如RESTful API设计、ManagerBase模式、Guid v7 ID使用）以及明确的开发约束（如避免管理器交叉调用、不使用响应包装器）。当AI辅助开发需要理解项目上下文时，此文档是首要参考，确保生成的代码准确、可维护且符合团队约定。关键词：Perigon开发规范，AI代码生成指南，项目结构地图，RESTful API设计，ManagerBase模式，Guid v7，Code First EF，智能体开发约束。

后端开发 0 次安装 0 次浏览更新于 3/2/2026

名称: perigon-agent 描述: Copilot/智能体应用Perigon规范的指南

何时使用

在生成代码前需要了解项目规则、文件位置或文档时。

使用说明

首先查阅 .github/copilot-instructions.md（全局规则：准确性优先，除非要求否则不构建，检查诊断信息）。
后端地图：定义位于 src/Definition/{Entity,EntityFramework,Share,ServiceDefaults}；管理器/DTO位于 src/Modules/{模块名}/{Managers,Models}；控制器位于 src/Services/*/Controllers；宿主程序位于 src/AppHost。
前端地图：Angular应用位于 src/ClientApp/WebApp（路由 app/app.routes.ts，服务 app/services，共享组件 app/share/components，国际化 assets/i18n）。
关键文档：Development-Conventions、Manager-Business-Logic、Controller-APIs、Database、Data-Access、Directory-Structure，详见 https://dusi.dev/docs/Perigon/en-US/10.0/…
行为默认值：RESTful API；ManagerBase模式；Code First EF；Guid v7 ID；使用BusinessException/Problem处理错误；优先使用查询投影而非大量Include；避免管理器间相互调用；不使用ApiResponse包装器。
当不明确时：询问实体/DTO详情和目标模块/服务；不要假设；避免自动运行构建/迁移。