api-design-expert by shipshitdev/library
npx skills add https://github.com/shipshitdev/library --skill api-design-expert精通 RESTful API 设计、OpenAPI/Swagger 文档编写、版本控制策略、错误处理以及 NestJS 应用程序的 API 最佳实践。
在提供指导之前:
.agents/SYSTEM/ARCHITECTURE.md 以了解 API 模式// 使用名词、复数形式、层级结构
GET /api/users
GET /api/users/:id
POST /api/users
PUT /api/users/:id
DELETE /api/users/:id
GET /api/users/:id/posts
200 OK / 201 Created / 广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
204 No Content400 Bad Request / 401 Unauthorized / 403 Forbidden404 Not Found / 409 Conflict / 500 Internal Server Error// 单个资源
{ "data": {...}, "meta": {...} }
// 带分页的列表
{ "data": [...], "pagination": { "page", "limit", "total" } }
{
"error": {
"code": "VALIDATION_ERROR",
"message": "验证失败",
"details": [...],
"timestamp": "...",
"path": "/api/users"
}
}
有关完整的 DTO 示例、分页/过滤/排序模式、版本控制策略、OpenAPI 设置、CRUD 控制器模式、嵌套资源、批量操作和反模式,请参阅: references/full-guide.md
每周安装量
82
代码仓库
GitHub 星标数
16
首次出现时间
2026年1月20日
安全审计
安装于
codex59
claude-code57
gemini-cli56
opencode56
cursor53
github-copilot49
Expert in RESTful API design, OpenAPI/Swagger documentation, versioning strategies, error handling, and API best practices for NestJS applications.
Before providing guidance:
.agents/SYSTEM/ARCHITECTURE.md for API patterns// Use nouns, plural, hierarchical
GET /api/users
GET /api/users/:id
POST /api/users
PUT /api/users/:id
DELETE /api/users/:id
GET /api/users/:id/posts
200 OK / 201 Created / 204 No Content400 Bad Request / 401 Unauthorized / 403 Forbidden404 Not Found / 409 Conflict / 500 Internal Server Error// Single resource
{ "data": {...}, "meta": {...} }
// List with pagination
{ "data": [...], "pagination": { "page", "limit", "total" } }
{
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"details": [...],
"timestamp": "...",
"path": "/api/users"
}
}
For complete DTO examples, pagination/filtering/sorting patterns, versioning strategies, OpenAPI setup, CRUD controller patterns, nested resources, bulk operations, and anti-patterns, see: references/full-guide.md
Weekly Installs
82
Repository
GitHub Stars
16
First Seen
Jan 20, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
codex59
claude-code57
gemini-cli56
opencode56
cursor53
github-copilot49
agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
166,500 周安装
ScoutQA AI驱动Web应用探索性测试工具 - 自动化测试与验证解决方案
8,100 周安装
PlantUML ASCII 图表生成器 - 命令行文本图表工具,支持序列图、类图、活动图
8,200 周安装
pytest-coverage:Python测试覆盖率工具,一键生成代码覆盖率报告
8,300 周安装
Markdown转HTML专业技能 - 使用marked.js、Pandoc和Hugo实现高效文档转换
8,200 周安装
GitHub Copilot 技能模板制作指南 - 创建自定义 Agent Skills 分步教程
8,200 周安装
ImageMagick图像处理技能:批量调整大小、格式转换与元数据提取
8,200 周安装