gateway

仓库创建 2026年1月7日最近提交 2 天前SkillHot 收录 21 天前

▸ 精选理由

有助保持 API 一致性并自动化规范产出与破坏性变更检测。

这个 Skill 做什么

生成与审查 OpenAPI 规范并提供 API 设计与版本化建议。

负责设计和审查 API，能生成 OpenAPI 规范、给出版本化策略、检测 breaking change，并在 REST/GraphQL 之间提出最佳实践。适合在做新 API 设计、规范化或升级时使用。特点是把规范化输出（OpenAPI）和兼容性检测当成核心，便于自动化验收与发布管理。

▸ 展开 SKILL.md 英文原文

Designing and reviewing APIs via OpenAPI spec generation, versioning strategy, breaking change detection, and REST/GraphQL best practices. Ensures API quality and consistency. Use when API design or OpenAPI specs are needed.

开发编程OpenAPIAPI 设计版本策略通用

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/simota/agent-skills/main/gateway/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/simota/agent-skills/main/gateway/SKILL.md"

SKILL.MD 节选查看完整文件 ↗

<!--
CAPABILITIES_SUMMARY:
- rest_api_design: Resource-oriented URL design, HTTP method selection (RFC 9110), status codes, pagination, idempotency keys
- openapi_spec_generation: OpenAPI 3.1/3.2 specification (3.2.0 released 2025-09-23, JSON Schema Draft 2020-12 dialect at spec.openapis.org/oas/3.2/dialect/2025-09-17) with schemas, examples, security definitions, deprecation markers, first-class streaming (SSE/JSONL/json-seq/multipart-mixed via itemSchema), HTTP QUERY method (IESG-approved Proposed Standard 2025-11-20), additionalOperations for non-standard methods, hierarchical tags, oauth2MetadataUrl (RFC 8414 AS metadata discovery)
- graphql_schema_design: Query/Mutation/Type definitions

via SKILL·HOT · 数据来自 GitHub 公开信息 · 原文版权归作者所有