Token导航 LogoToken导航TokenDH.com
开发需要联网github未标认证来源可访问许可证需确认审计未展示

openapi-specification-v3.2openapi 规范 v3 2

Agent Skill

用于辅助 API 设计、接口文档、请求响应结构和服务集成说明。它适合让 Agent 梳理 endpoint、生成 OpenAPI 草稿、检查字段命名、整理错误码或辅助前后端联调。使用时需要确认真实业务语义、鉴权方式、分页和错误处理规则;涉及生成接口文档时,应避免凭空补字段,最好从现有代码、schema 或接口样例中提取事实。

总安装

11,904

周安装

501

GitHub Stars

15

下载量

4,168
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:openapi-specification-v3.2(openapi 规范 v3 2)
来源仓库:https://github.com/hairyf/skills
仓库路径:skills/openapi-specification-v3.2
安装命令:
npx skills add https://github.com/hairyf/skills --skill openapi-specification-v3.2
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/hairyf/skills --skill openapi-specification-v3.2

简介

用于辅助 API 设计、接口文档、请求响应结构和服务集成说明。

  • 适合梳理 endpoint、生成 OpenAPI 草稿、检查字段命名或整理错误码。
  • 通过 npx skills add 命令从指定仓库安装并使用该技能。
  • 使用时需确认业务语义、鉴权方式、分页和错误处理规则,避免凭空补字段。
  • 建议从现有代码、schema 或接口样例中提取事实,确保文档准确性。

SKILL.md

OpenAPI Specification 3.2

Agent-oriented reference for the OpenAPI Specification 3.2.0. Use when editing, generating, or validating OpenAPI descriptions (OAD).

When to Use

  • Authoring or updating OpenAPI 3.2 YAML/JSON documents
  • Resolving $ref, $self, and relative URIs in multi-document OADs
  • Describing paths, operations, parameters (query/path/header/cookie/querystring), request body, and responses
  • Using Schema Objects (JSON Schema Draft 2020-12 dialect), components, and references
  • Configuring security schemes (apiKey, http, mutualTLS, oauth2, openIdConnect) and requirements
  • Working with media types, encoding (form, multipart), and examples (dataValue/serializedValue/externalValue)

Core References

TopicDescriptionReference
OpenAPI ObjectRoot object, openapi, $self, info, servers, paths, webhooks, components, security, tagscore-openapi-object
Format & StructureJSON/YAML, case sensitivity, rich text, OAD structure, parsing, base URIcore-format-and-structure
Fixed & Patterned FieldsFixed vs patterned fields, paths keys, components keys, extensions (x-)core-fixed-patterned-fields
Info & MetadataInfo, Contact, License objectscore-info-metadata
ServerServer Object, Server Variable, URL templatingcore-server
Paths & OperationsPaths Object, Path Item, Operation Object, additionalOperations, querypaths-and-operations
Path TemplatingPath templating, path parameters, matching, ABNFcore-path-templating
ParametersParameter Object, in (path/query/header/cookie/querystring), style, schema vs contentparameters
Request Body & Media TypeRequest Body, Media Type Object, sequential media types, itemSchemarequest-body-and-media-type
Encoding ObjectEncoding by name/position, contentType, style, explode, form, multipartcore-encoding-object
Media TypesContent keys, media type ranges, OpenAPI Media Type Registrycore-media-types
ResponsesResponses Object, Response Object, headers, content, linksresponses
HTTP Status CodesResponse keys, default, 1XX–5XX range with Xcore-http-status-codes
Schema & ComponentsSchema Object (JSON Schema 2020-12), Components, $ref resolutionschema-and-components
Schema JSON Schema KeywordsJSON Schema 2020-12 keywords and OAS extensions in Schemaschema-json-schema-keywords
Schema Composition & PolymorphismallOf, oneOf, anyOf, discriminatorschema-composition-polymorphism
Data Types & FormatsJSON Schema types, format keyword, OAS dialectcore-data-types-and-formats
Discriminator & XMLDiscriminator Object, XML Object (nodeType, name, namespace)core-discriminator-and-xml
Components ReuseReusing parameters, responses, schemas via $refcomponents-reuse
Reference Object$ref, summary/description override, resolution rulescore-reference-object
Header ObjectResponse/multipart headers, style simple, Set-Cookie, Linkcore-header-object
Example ObjectdataValue, serializedValue, value, externalValue, Working with Examplescore-example-object
Tag & External DocsTag Object, External Documentation Object, parent, kindcore-tags-and-external-docs
Link ObjectoperationRef, operationId, parameters, requestBodycore-link-object
Runtime Expressions$request, $response, $url, $method, ABNF, Link/Callback usagecore-runtime-expressions
SecuritySecurity Scheme, OAuth Flows, Security Requirement Objectsecurity
Security Scheme TypesapiKey, http (basic/bearer), mutualTLS, oauth2, openIdConnectsecurity-scheme-types
Security Requirement ObjectOR/AND semantics, {} optional, [] clear, scopessecurity-requirement-object
OAuth2 FlowsOAuth Flows Object, OAuth Flow Object, authorizationCode, deviceAuthorizationsecurity-oauth2-flows
Callbacks & WebhooksCallback Object, webhookscallbacks-and-webhooks
ExtensionsSpecification extensions (x-), extension registriesadvanced-extensions

Best Practices

TopicDescriptionReference
Spec AuthoringoperationId, tags, $self, components reuse, responses, securitybest-practices-spec-authoring

Advanced

TopicDescriptionReference
Base URI & Resolution$self, retrieval URI, reference resolution, parsing guidanceadvanced-base-uri-and-resolution
Security FilteringEmpty Paths/Path Item, Security Considerationsadvanced-security-filtering

Key Points

  • OAS 3.2 root uses 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.
  • Schema Object is a superset of JSON Schema Draft 2020-12; empty schema = true, none = false.
  • Parameter: use either schema+style or content (one Media Type); in: "querystring" requires content.
  • Security at root is OR (one of the Security Requirement Objects); per-operation overrides; {} = optional.

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

35.35%
按下载量换算1,473

Claude

28.69%
按下载量换算1,196

Cursor

20.79%
按下载量换算867

Gemini CLI

8.83%
按下载量换算368

安全审计

暂无安全审计结果可展示。

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills