api-forge

仓库创建 2026年5月12日最近提交 10 小时前SkillHot 收录 20 天前

▸ 精选理由

基于成熟产品模式生成可交付的 API 规范，利于开发与文档对齐。

这个 Skill 做什么

根据需求设计 REST/GraphQL 接口，并生成符合 OpenAPI 3.1 的规范与最佳实践。

帮你把业务需求变成可用的 REST/GraphQL 接口设计，会产出符合 OpenAPI 3.1 的规范文档、错误处理、分页、限流、webhook 和幂等策略。适合在要规划 API 端点、定义 schema 或生成对外文档时用，能直接给开发团队可执行的规范。特点是借鉴 Stripe、GitHub 等成熟模式，产出易用且标准化的 OpenAPI spec。

▸ 展开 SKILL.md 英文原文

Design REST/GraphQL APIs with OpenAPI 3.1, error handling, pagination, rate limiting, webhooks, and idempotency. Use when user asks to design an API, create endpoints, define REST/GraphQL schema, or generate OpenAPI spec. Do NOT use for database schema design, frontend API integration, or non-HTTP protocols (gRPC, WebSocket, MQTT).

开发编程APIOpenAPI设计规范通用

110

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/.pack/skills/api-forge/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/EliasOulkadi/shokunin/master/.pack/skills/api-forge/SKILL.md"

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

# API Forge

Design APIs that developers love. Based on patterns from Stripe, GitHub, Twilio, Slack, and the OpenAPI 3.1 specification.

## Sub-Commands

| Command | Category | Description |
|---------|----------|-------------|
| `design` | Build | Design an API from user requirements. Generate OpenAPI 3.1 spec. |
| `endpoint` | Build | Design a single endpoint with all methods, parameters, responses, and error codes. |
| `audit` | Evaluate | Audit an existing API against design rules, security checklist, and anti-patterns. |
| `document` | Document | Generate API documentation from OpenAPI spec or route handlers. |
| `extract` | Document | Extract OpenAPI spec from existing route handlers.

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