Token导航 LogoToken导航

Agent Skill · 开发

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

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

openapi-specification-v3.2 是开发类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为需要联网;许可证信息还不明确,暂无第三方扫描结果,按安装量在开发类的 21,746 个 Skill 里排第 3,313。

总安装 11,904周安装 501GitHub Stars 15下载 4,168核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 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

这个 Skill 是做什么的

开发类 Skill 面向写代码、改代码和排查问题,一般会读写仓库文件,部分还会执行构建或测试命令。

用于辅助 API 设计、接口文档、请求响应结构和服务集成说明。适合梳理 endpoint、生成 OpenAPI 草稿、检查字段命名或整理错误码。通过 npx skills add 命令从指定仓库安装并使用该技能。使用时需确认业务语义、鉴权方式、分页和错误处理规则,避免凭空补字段。

建议从现有代码、schema 或接口样例中提取事实,确保文档准确性。

来源仓库内路径:skills/openapi-specification-v3.2

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/hairyf/skills --skill openapi-specification-v3…;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要需要联网,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

openapi-specification-v3.2 怎么安装?

在终端执行 npx skills add https://github.com/hairyf/skills --skill openapi-specification-v3.2。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

openapi-specification-v3.2 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

openapi-specification-v3.2 需要什么权限?

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

openapi-specification-v3.2 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

openapi-specification-v3.2 用的人多吗?

公开数据是累计安装 11,904 次,近一周安装 501 次,下载 4,168 次,GitHub 15 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

openapi-specification-v3.2 安全吗?

没有查到第三方扫描结果,安全性无法从公开资料判断,安装前请自行审查源码、依赖和命令行为。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 没有第三方扫描结果,安全性只能靠自己读源码判断。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理开发类任务、又不想每次都手写提示词的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 要求有安全扫描结论才肯安装的团队。
  • 需要厂商级技术支持和 SLA 的生产系统。

开发类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
skill-vetter

技能审查员 · OpenClaw

8,779,018986操作浏览器MIT-0通过
ontology

本体论 · OpenClaw

6,636,960576只读MIT-0通过
entra-app-registration

内部应用程序注册 · Codex、Claude

6,631,872764接触敏感数据未明确通过
entra-app-registration

内部应用程序注册 · Codex、Claude

3,757,680201接触敏感数据未明确通过
nano-banana-pro

纳米香蕉专业版 · OpenClaw

3,526,898364接触敏感数据MIT-0有提醒
openapi-specification-v3.2

openapi 规范 v3 2 · 本页

11,90415需要联网未明确未收录

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

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.

平台分布

Codex

35.35%
按下载量换算1,473

Claude

28.69%
按下载量换算1,196

Cursor

20.79%
按下载量换算867

Gemini CLI

8.83%
按下载量换算368

安全审计

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

权限和风险

需要联网

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

安装前确认

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

继续浏览同类 Skills