api-design-principles

仓库创建 2025年11月8日最近提交 29 天前SkillHot 收录 22 天前

▸ 精选理由

面向设计与审查阶段，帮助打造更直观和可扩展的 API 规范。

这个 Skill 做什么

REST 与 GraphQL 的 API 设计原则与最佳实践，提升可用性与可维护性。

讲清楚怎么设计既直观又易维护的接口，覆盖 REST 和 GraphQL 的命名、版本、分页、错误和一致性等要点，帮团队减少未来改动成本。会在新建 API、评审规范或统一团队标准时用到。特别强调开发者体验和可扩展性，让别人能顺手用你的 API。

▸ 展开 SKILL.md 英文原文

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

开发编程API 设计RESTGraphQL通用

180

Stars

Forks

仓库内 Skill

7 日增星

安装 / 使用

给你的 Agent 一句话（通用）

帮我安装这个 skill：https://raw.githubusercontent.com/secondsky/claude-skills/main/plugins/api-design-principles/skills/api-design-principles/SKILL.md

或 curl 直取 SKILL.md

curl -fsSL "https://raw.githubusercontent.com/secondsky/claude-skills/main/plugins/api-design-principles/skills/api-design-principles/SKILL.md"

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

# API Design Principles

Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.

## When to Use This Skill

- Designing new REST or GraphQL APIs
- Refactoring existing APIs for better usability
- Establishing API design standards for your team
- Reviewing API specifications before implementation
- Migrating between API paradigms (REST to GraphQL, etc.)
- Creating developer-friendly API documentation
- Optimizing APIs for specific use cases (mobile, third-party integrations)

## Core Concepts

### 1. RESTful Design Principles

**Resource-Oriented Architecture**
- Resources are nouns (users, orders,

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