Claude Code API 合同技能｜约定前后端分页请求与响应

Claude Code 安装步骤

从固定版本 GitHub 工作副本获取完整的 `plugins/community/sprint/skills/api-contract` 目录。
将目录放入目标项目的 `.claude/skills/`，确认 `.claude/skills/api-contract/SKILL.md` 存在，再从项目根目录启动 Claude Code 并输入 `/api-contract`。

给前后端写一份共享接口合同，明确分页参数、响应类型、空列表语义和请求错误。

为 `GET /books` 写合同。约定 `page` 与 `limit`，用同一响应结构描述查到一项、没有匹配项及错误输入。

交付内容应包含有数据和空列表的成功示例，以及单独的错误响应。前后端可直接据此写测试。

GitHub 原文 · 更新日期 2026-11-13

准备同一项功能的页面和 API 需求。示例可在临时项目中起草一份 Markdown 合同。

合同记录调用方可见的字段与约束。数据库查询实现可放在服务设计中。