跳到正文
cccskills
免费在 GitHub 公开中文介绍

api-design-principles

依据 REST 和 GraphQL 设计原则规划或评审 API 规格,整理资源与模式设计、分页、版本管理和错误处理,并参考示例、清单、模板及 OpenAPI 生成脚本。

原文查看原文说明

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.

LeoYeAI/agent-master-skills星标 2,193(GitHub 2,193 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • 规划新 API 规格
  • 在实现前评审 API
  • 统一团队 API 设计规范
  • 考虑 REST 与 GraphQL 迁移

中文介绍

功能

依据 REST 和 GraphQL 的设计原则规划或评审 API 规格。设计 REST API 时,可以考虑资源如何表示以及 HTTP 方法如何使用;设计 GraphQL 时,可以整理模式和查询结构。内容还涉及分页、筛选、错误响应、版本管理和常见设计问题。GraphQL 部分提供类型、变更操作和解析器示例,并介绍用于高效获取关联数据的 DataLoader 思路。资料还包含 API 评审和团队设计规范所需的检查清单、模板,以及用于生成 OpenAPI 规格的脚本。

适用场景

在实现前确定新 API 规格,或重新检查现有 API 是否易用时,可以使用此技能。它也适用于比较 REST 和 GraphQL、考虑两者之间的迁移,或统一团队设计规则。

使用示例

  • “请评审这个 REST API 的端点设计。”
  • “为用户和订单拟定一份 GraphQL 模式。”
  • “比较 API 版本管理方案。”

注意事项

特記事項はありません。

本介绍由 AI(OpenAI Codex)根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

文档检查

AI 根据 SKILL.md 的内容检查了需要注意的操作和使用前提。评分只依据实际运行的结果(实测对比)。

安全性发送数据、删除文件、执行命令等是否有说明
A良好包含 DELETE 设计示例,但没有执行外部操作的指示。
安装难易度所需工具和 API 密钥是否少且有说明
A良好未提及 API 密钥或外部服务前提。

不计入评分。 由 AI(OpenAI Codex)于 2026年11月15日 评估。仅供参考,安装前请同时查看原文。

如果您认为评估有误,请申请复核

请写明哪一项有误以及原因。无需登录。我们会对照 SKILL.md 重新评估,并在此处更新结果。

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

包含的文件(5)

  • SKILL.md13.4 KB
  • assets/api-design-checklist.md3.8 KB
  • assets/rest-api-template.py5.2 KB
  • references/graphql-schema-design.md8.8 KB
  • references/rest-best-practices.md7.4 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

0codekit

免费有简介

通过Membrane CLI连接0codekit工作区数据,可处理表格、数据库、任务、日历、邮件、聊天消息和文档等信息;请求不明确时需补充应用或数据细节。

  • 处理0codekit工作区信息
  • 查看表格或数据库数据
  • 查询任务和日历活动
LeoYeAI/agent-master-skills21932026年11月1日 更新

0xarchive

免费有简介

通过0xArchive API查询Hyperliquid、Lighter.xyz和HIP-3的历史及当前市场数据,包括价格、订单簿、交易、资金费率、未平仓量和清算,并检查数据更新时间与覆盖范围。

  • 查询支持交易所的历史价格
  • 查看订单簿和交易记录
  • 跟踪资金费率与未平仓量
LeoYeAI/agent-master-skills21932026年11月1日 更新

12-factor-apps

免费有简介

依据12-Factor App的12项原则检查代码库,逐项评估配置、依赖和日志等方面,并提供文件与行号证据、问题说明及按优先级排列的改进建议。

  • 审查SaaS应用架构
  • 排查云迁移前的配置问题
  • 容器化前检查应用
LeoYeAI/agent-master-skills21932026年11月1日 更新

13-Day Sprint Method

免费有简介

以玛雅历为灵感,用13天一个周期推进个人或团队项目。每天的“音调”提示行动重点,涵盖设定目标、执行、发布成果、整理和复盘。

  • 用13天推进个人项目
  • 为团队冲刺安排每日重点
  • 查询今天的行动提示
LeoYeAI/agent-master-skills21932026年11月1日 更新

13c-metabolic-flux

免费有简介

根据稳态碳13示踪测量估算细胞内代谢通量,检查碳原子映射和测量输入,模拟标记分布并拟合受约束的通量,以判断数据能约束哪些通路反应速率。

  • 根据碳13测量估算代谢通量
  • 检查原子映射与测量输入
  • 根据指定通量预测标记分布
LeoYeAI/agent-master-skills21932026年11月1日 更新

1688 Sourcing Agent

免费有简介

此技能按步骤指导你通过 1688.com 选品、核查供应商、申请样品、议价并比较运输方式,也会梳理商品信息和付款风险,以及何时应咨询采购专家。

  • 核查 1688.com 供应商
  • 按预算筛选商品
  • 议价或申请样品
LeoYeAI/agent-master-skills21932026年11月1日 更新

查看 LeoYeAI 的全部技能

报告此技能的问题