openapi-specification-v3.2 by hairyf/skills
npx skills add https://github.com/hairyf/skills --skill openapi-specification-v3.2面向代理的 OpenAPI 规范 3.2.0 参考。在编辑、生成或验证 OpenAPI 描述 (OAD) 时使用。
$ref、$self 和相对 URI 时| 主题 | 描述 | 参考链接 |
|---|---|---|
| OpenAPI 对象 | 根对象,openapi,$self,info,servers,paths,webhooks,components,security,tags | core-openapi-object |
| 格式与结构 | JSON/YAML,大小写敏感性,富文本,OAD 结构,解析,基础 URI | core-format-and-structure |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 固定与模式化字段 | 固定字段 vs 模式化字段,路径键,组件键,扩展(x-) | core-fixed-patterned-fields |
| 信息与元数据 | Info、Contact、License 对象 | core-info-metadata |
| 服务器 | Server 对象,Server 变量,URL 模板化 | core-server |
| 路径与操作 | Paths 对象,Path Item,Operation 对象,additionalOperations,查询 | paths-and-operations |
| 路径模板化 | 路径模板化,路径参数,匹配,ABNF | core-path-templating |
| 参数 | Parameter 对象,in(路径/查询/头部/cookie/查询字符串),style,schema vs content | parameters |
| 请求体与媒体类型 | Request Body,Media Type 对象,顺序媒体类型,itemSchema | request-body-and-media-type |
| Encoding 对象 | 按名称/位置编码,contentType,style,explode,form,multipart | core-encoding-object |
| 媒体类型 | Content 键,媒体类型范围,OpenAPI 媒体类型注册表 | core-media-types |
| 响应 | Responses 对象,Response 对象,headers,content,links | responses |
| HTTP 状态码 | Response 键,default,1XX–5XX 范围(带 X) | core-http-status-codes |
| 模式与组件 | Schema 对象(JSON Schema 2020-12),Components,$ref 解析 | schema-and-components |
| Schema JSON Schema 关键词 | Schema 中的 JSON Schema 2020-12 关键词和 OAS 扩展 | schema-json-schema-keywords |
| 模式组合与多态性 | allOf,oneOf,anyOf,discriminator | schema-composition-polymorphism |
| 数据类型与格式 | JSON Schema 类型,format 关键词,OAS 方言 | core-data-types-and-formats |
| Discriminator 与 XML | Discriminator 对象,XML 对象(nodeType,name,namespace) | core-discriminator-and-xml |
| 组件复用 | 通过 $ref 复用参数、响应、模式 | components-reuse |
| Reference 对象 | $ref,summary/description 覆盖,解析规则 | core-reference-object |
| Header 对象 | 响应/多部分头部,style simple,Set-Cookie,Link | core-header-object |
| Example 对象 | dataValue,serializedValue,value,externalValue,使用示例 | core-example-object |
| 标签与外部文档 | Tag 对象,External Documentation 对象,parent,kind | core-tags-and-external-docs |
| Link 对象 | operationRef,operationId,parameters,requestBody | core-link-object |
| 运行时表达式 | $request,$response,$url,$method,ABNF,Link/Callback 用法 | core-runtime-expressions |
| 安全性 | Security Scheme,OAuth Flows,Security Requirement 对象 | security |
| 安全方案类型 | apiKey,http(basic/bearer),mutualTLS,oauth2,openIdConnect | security-scheme-types |
| Security Requirement 对象 | OR/AND 语义,{} 可选,[] 清除,作用域 | security-requirement-object |
| OAuth2 流程 | OAuth Flows 对象,OAuth Flow 对象,authorizationCode,deviceAuthorization | security-oauth2-flows |
| 回调与 Webhooks | Callback 对象,webhooks | callbacks-and-webhooks |
| 扩展 | 规范扩展(x-),扩展注册表 | advanced-extensions |
| 主题 | 描述 | 参考链接 |
|---|---|---|
| 规范编写 | operationId,tags,$self,组件复用,responses,security | best-practices-spec-authoring |
| 主题 | 描述 | 参考链接 |
|---|---|---|
| 基础 URI 与解析 | $self,检索 URI,引用解析,解析指南 | advanced-base-uri-and-resolution |
| 安全过滤 | 空 Paths/Path Item,安全注意事项 | advanced-security-filtering |
openapi: 3.2.0;components、paths 或 webhooks 中至少必须存在一个。$self 提供文档的基础 URI 用于引用解析;在多文档 OAD 中使用它。true,无模式 = false。schema+style 或 content(一种媒体类型)之一;in: "querystring" 需要 content。{} 表示可选。每周安装量
392
代码仓库
GitHub 星标数
6
首次出现
Jan 30, 2026
安装于
cursor379
claude-code364
codex125
opencode124
github-copilot122
gemini-cli122
Agent-oriented reference for the OpenAPI Specification 3.2.0. Use when editing, generating, or validating OpenAPI descriptions (OAD).
$ref, $self, and relative URIs in multi-document OADs| Topic | Description | Reference |
|---|---|---|
| OpenAPI Object | Root object, openapi, $self, info, servers, paths, webhooks, components, security, tags | core-openapi-object |
| Format & Structure | JSON/YAML, case sensitivity, rich text, OAD structure, parsing, base URI | core-format-and-structure |
| Fixed & Patterned Fields | Fixed vs patterned fields, paths keys, components keys, extensions (x-) | core-fixed-patterned-fields |
| Info & Metadata | Info, Contact, License objects | core-info-metadata |
| Server | Server Object, Server Variable, URL templating | core-server |
| Paths & Operations | Paths Object, Path Item, Operation Object, additionalOperations, query | paths-and-operations |
| Path Templating | Path templating, path parameters, matching, ABNF | core-path-templating |
| Parameters | Parameter Object, in (path/query/header/cookie/querystring), style, schema vs content | parameters |
| Request Body & Media Type | Request Body, Media Type Object, sequential media types, itemSchema | request-body-and-media-type |
| Encoding Object | Encoding by name/position, contentType, style, explode, form, multipart | core-encoding-object |
| Media Types | Content keys, media type ranges, OpenAPI Media Type Registry | core-media-types |
| Responses | Responses Object, Response Object, headers, content, links | responses |
| HTTP Status Codes | Response keys, default, 1XX–5XX range with X | core-http-status-codes |
| Schema & Components | Schema Object (JSON Schema 2020-12), Components, $ref resolution | schema-and-components |
| Schema JSON Schema Keywords | JSON Schema 2020-12 keywords and OAS extensions in Schema | schema-json-schema-keywords |
| Schema Composition & Polymorphism | allOf, oneOf, anyOf, discriminator | schema-composition-polymorphism |
| Data Types & Formats | JSON Schema types, format keyword, OAS dialect | core-data-types-and-formats |
| Discriminator & XML | Discriminator Object, XML Object (nodeType, name, namespace) | core-discriminator-and-xml |
| Components Reuse | Reusing parameters, responses, schemas via $ref | components-reuse |
| Reference Object | $ref, summary/description override, resolution rules | core-reference-object |
| Header Object | Response/multipart headers, style simple, Set-Cookie, Link | core-header-object |
| Example Object | dataValue, serializedValue, value, externalValue, Working with Examples | core-example-object |
| Tag & External Docs | Tag Object, External Documentation Object, parent, kind | core-tags-and-external-docs |
| Link Object | operationRef, operationId, parameters, requestBody | core-link-object |
| Runtime Expressions | $request, $response, $url, $method, ABNF, Link/Callback usage | core-runtime-expressions |
| Security | Security Scheme, OAuth Flows, Security Requirement Object | security |
| Security Scheme Types | apiKey, http (basic/bearer), mutualTLS, oauth2, openIdConnect | security-scheme-types |
| Security Requirement Object | OR/AND semantics, {} optional, [] clear, scopes | security-requirement-object |
| OAuth2 Flows | OAuth Flows Object, OAuth Flow Object, authorizationCode, deviceAuthorization | security-oauth2-flows |
| Callbacks & Webhooks | Callback Object, webhooks | callbacks-and-webhooks |
| Extensions | Specification extensions (x-), extension registries | advanced-extensions |
| Topic | Description | Reference |
|---|---|---|
| Spec Authoring | operationId, tags, $self, components reuse, responses, security | best-practices-spec-authoring |
| Topic | Description | Reference |
|---|---|---|
| Base URI & Resolution | $self, retrieval URI, reference resolution, parsing guidance | advanced-base-uri-and-resolution |
| Security Filtering | Empty Paths/Path Item, Security Considerations | advanced-security-filtering |
openapi: 3.2.0; at least one of components, paths, or webhooks MUST be present.$self provides the document's base URI for reference resolution; use it in multi-document OADs.true, none = false.schema+style or content (one Media Type); in: "querystring" requires .Weekly Installs
392
Repository
GitHub Stars
6
First Seen
Jan 30, 2026
Installed on
cursor379
claude-code364
codex125
opencode124
github-copilot122
gemini-cli122
agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
140,500 周安装
content{} = optional.