Claude Code FastAPI 技能：先定义只读列表契约再实现路由
EnglishClaude Code 安装步骤
- 从固定版本 GitHub 工作副本获取完整的 `cli-tool/components/skills/web-development/fastapi-endpoint` 目录。
- 将目录放入目标项目的 `.claude/skills/`，确认 `.claude/skills/fastapi-endpoint/SKILL.md` 存在，再从项目根目录启动 Claude Code 并输入 `/fastapi-endpoint`。
中文摘要
先从项目现有模型和测试约定理解需求，再澄清列表字段、过滤和分页。适合在编码前形成能逐项核对的 FastAPI 接口契约。
SKILL.md 中文导读
可复现示例
给虚构活动目录添加公开只读列表。仅返回标题和开始时间，可按月份筛选；请先确认空结果和无效月份输入的行为。工作步骤
- 查看相邻路由、响应模型和测试样例，再确认列表的字段和边界。
- 为普通、空结果和无效过滤条件分别定义预期结果，再编写相应检查。
验收方法
接口契约需列出查询参数和返回字段，并分别覆盖有数据、空列表和无效月份三种样本。不要把未确认的分页策略写成事实。
GitHub 原文 · 更新日期
适用环境
Claude Code、固定版本技能和使用 FastAPI 的本地项目。需运行验证时准备项目采用的 Pydantic 和 pytest 环境。
常见问题
接到接口需求可以先直接改代码吗？
先核对项目现有模式，并确认输入、响应和边界情况。明确验收后再实现或补测试。