mcpField
A
api-design-principles

api-design-principles

github.com/davila7开发33.0k42 次安装今天更新
代码仓库

关于 api-design-principles

用于规划和审查 REST 与 GraphQL API 的技能，面向开发者和团队，涵盖 API 风格、资源或类型建模、错误、版本、分页、认证及一致性检查。

主要功能

  1. 01REST 与 GraphQL 设计指导
  2. 02分析使用者与约束
  3. 03资源和类型建模
  4. 04错误、版本、分页与认证
  5. 05规范验证与审查
  6. 06实现模式和模板

适用场景

  1. 01设计新的 REST 或 GraphQL API
  2. 02实现前审查 API 规范
  3. 03制定团队 API 设计标准
  4. 04规划 API 迁移或文档

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davila7/claude-code-templates --skill api-design-principles

安装后在 Claude Code 中输入/api-design-principles确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
api-design-checklist.md
rest-api-template.py
references/
graphql-schema-design.md
rest-best-practices.md
resources/
implementation-playbook.md

详细介绍

API 设计原则

掌握 REST 和 GraphQL API 设计原则，构建直观、可扩展且易于维护的 API，让开发者称心，并经得起时间考验。

适用场景

  • 设计新的 REST 或 GraphQL API
  • 重构现有 API，以提升易用性
  • 为团队制定 API 设计标准
  • 在实现前审查 API 规范
  • 在不同 API 范式之间迁移（如从 REST 迁移到 GraphQL）
  • 创建便于开发者使用的 API 文档
  • 针对特定使用场景优化 API（移动端、第三方集成）

不适用场景

  • 你只需要特定框架的实现指导
  • 你只处理基础设施，不涉及 API 契约
  • 你无法更改或为公共接口进行版本控制

说明

  1. 明确使用者、使用场景和约束条件。
  2. 选择 API 风格，并对资源或类型建模。
  3. 指定错误处理、版本控制、分页和身份验证策略。
  4. 通过示例进行验证，并检查一致性。

详细模式、清单和模板请参阅 resources/implementation-playbook.md。

资源

  • resources/implementation-playbook.md：详细模式、清单和模板。

评论

支持 Markdown