perigon

name	perigon
description	"使用 Perigon CLI 进行解决方案脚手架、模块/服务添加、OpenAPI 客户端生成、MCP Server 配置与启动、Studio 面板管理、模块打包与安装。USE FOR: perigon new, perigon add module, perigon add service, perigon generate request, perigon mcp config/start, perigon studio, perigon pack, perigon install.

Perigon Skill

This repository uses Perigon.CLI for code generation, and MCP integration.

CLI command reference

Task	Command
Create a new solution	perigon new <name>
Launch Studio	perigon studio
Update Studio	perigon studio update
Add a module	perigon add module <ModuleName>
Add a service	perigon add service <ServiceName>
Generate request client	`perigon generate request <path
Generate models only	`perigon generate request <path
Show MCP config	perigon mcp config
Start MCP server	perigon mcp start
Pack a module	perigon pack <ModuleName> <ServiceName>
Install a module package	perigon install <PackagePath> <ServiceName>
List official modules	perigon install -l
Show command help	perigon -h or perigon <command> -h

Key workflows

Generating request clients from OpenAPI

Use perigon generate request when the task is to generate typed request services or models from a Swagger/OpenAPI document.

perigon generate request ./openapi.json ./src/services -t angular

Supported types: angular (default), csharp, axios.

In this repository, the preferred frontend outputPath is the absolute path of src/ClientApp/WebApp/src/app.

Important rules

• Use Perigon for scaffolding and code generation, not for build/test/run.
• Prefer generated code over hand-written boilerplate for modules, services, and request clients.
• For frontend API clients, prefer perigon generate request and keep generated contracts consistent with backend OpenAPI definitions.
• Do not manually edit generated request contracts unless necessary; regenerate when the backend changes.
• Check help before guessing options with perigon <command> -h.

Notes

• perigon new and perigon studio are interactive solution-creation flows.
• perigon add module <ModuleName> allows omitting the Mod suffix.
• perigon pack <ModuleName> <ServiceName> expects the module name with the Mod suffix.
• perigon install accepts either a local zip path or an official package name such as Perigon.SystemMod.