Agent Skills
› midudev/autoskills
› aspnet-minimal-api-openapi
aspnet-minimal-api-openapi
GitHub指导创建结构化的ASP.NET Minimal API端点，涵盖分组、DTO定义、强类型处理及基于.NET 9的OpenAPI文档生成最佳实践。
Trigger Scenarios
需要创建或优化 ASP.NET Minimal API 接口
需要为现有 API 添加或完善 OpenAPI/Swagger 文档
Install
npx skills add midudev/autoskills --skill aspnet-minimal-api-openapi -g -y
SKILL.md
Frontmatter
{
"name": "aspnet-minimal-api-openapi",
"description": "Create ASP.NET Minimal API endpoints with proper OpenAPI documentation"
}
ASP.NET Minimal API with OpenAPI
Your goal is to help me create well-structured ASP.NET Minimal API endpoints with correct types and comprehensive OpenAPI/Swagger documentation.
API Organization
- Group related endpoints using
MapGroup()extension - Use endpoint filters for cross-cutting concerns
- Structure larger APIs with separate endpoint classes
- Consider using a feature-based folder structure for complex APIs
Request and Response Types
- Define explicit request and response DTOs/models
- Create clear model classes with proper validation attributes
- Use record types for immutable request/response objects
- Use meaningful property names that align with API design standards
- Apply
[Required]and other validation attributes to enforce constraints - Use the ProblemDetailsService and StatusCodePages to get standard error responses
Type Handling
- Use strongly-typed route parameters with explicit type binding
- Use
Results<T1, T2>to represent multiple response types - Return
TypedResultsinstead ofResultsfor strongly-typed responses - Leverage C# 10+ features like nullable annotations and init-only properties
OpenAPI Documentation
- Use the built-in OpenAPI document support added in .NET 9
- Define operation summary and description
- Add operationIds using the
WithNameextension method - Add descriptions to properties and parameters with
[Description()] - Set proper content types for requests and responses
- Use document transformers to add elements like servers, tags, and security schemes
- Use schema transformers to apply customizations to OpenAPI schemas
Version History
- 0ec7253 Current 2026-07-24 20:51
