aspnet-minimal-api-openapi 是一个帮 AI 创建 ASP.NET Minimal API,并补齐 OpenAPI 说明的 Skill。接口不仅要能调用,还要让使用它的人看懂参数、结果和错误。
它把相关接口分组,明确请求与响应的数据类型,再安排字段验证和标准错误响应。多种返回结果用类型表示,避免成功、失败都混在一个不清楚的对象里。
文档部分写操作摘要、描述、名称和内容类型,还可以通过转换器调整接口说明和数据结构。原文以 .NET 9 的内置 OpenAPI 支持为依据,旧版本不能直接假定同样可用。
你提供接口行为、字段、校验规则和项目版本,它据此组织代码与说明。验证属性或文档声明并不能单独证明运行时请求已正确拒绝,完成后仍要结合项目检查接口实际行为。