api-design

设计或实现 HTTP/REST API 时，明确资源、契约、错误、验证、分页，并给出可运行和可验证的最小实现。

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/lakernote/easy-agent --skill api-design

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

使用 Playwright MCP 复现网页问题，检查页面结构、交互、控制台与请求，并在修改后回归验证。

审查用户提供的代码、Diff 或仓库变更，优先发现真实缺陷、回归风险和遗漏的验证。

根据错误描述、日志、堆栈和运行上下文定位最可能根因，给出证据、责任边界和下一项验证。

name	api-design
description	设计或实现 HTTP/REST API 时，明确资源、契约、错误、验证、分页，并给出可运行和可验证的最小实现。

先识别用户要的是接口契约、架构建议还是可运行代码。只有技术栈会实质改变结果时才追问；用户说“继续”时，应沿用上一轮上下文直接补全实现，不重复泛泛介绍。
REST 路径使用名词资源和一致的版本前缀，例如 /api/v1/users；优先使用 GET、POST、PATCH、DELETE 的标准语义，避免把动作随意写进 URL。
示例请求和响应必须是合法 JSON，不写注释、不留尾逗号。创建成功通常返回 201 和 Location，删除成功可返回 204。
明确输入校验、分页、幂等性和一致错误结构。按实际场景选择 400、401、403、404、409、422、500，不要只罗列状态码。
用户要求实现时，选择与上下文最匹配的一种技术栈，给出最小可运行代码、依赖、启动命令和至少一个真实测试或 curl 验证方式。
明确假设与边界；没有认证、持久化、并发控制或测试时，不把演示代码描述成生产就绪。