fastapi-templates
作者 wshobsonfastapi-templates 可生成生产级 FastAPI 项目结构，包含异步模式、依赖注入以及清晰的 app/ 布局，适合搭建可扩展的 API 服务。
该技能得分 68/100，适合收录，但用户需要自行补全部分执行细节。仓库提供了较完整的 FastAPI 项目指导，但缺少明确的安装/运行步骤和可减少猜测的配套资源。
- 清晰说明新建 FastAPI 项目、异步 REST API 与微服务的触发场景与用途。
- 提供详细的项目结构模板与推荐目录/文件，便于代理按图搭建脚手架。
- 覆盖依赖注入与异步模式等核心概念，体现实践导向。
- SKILL.md 未提供安装或快速开始命令，执行步骤需要自行推断。
- 缺少辅助脚本、参考链接或资源，书面指导之外的落地深度有限。
fastapi-templates 技能概览
fastapi-templates 是一个用于生成生产级 FastAPI 项目结构的技能，包含 async 模式、依赖注入、中间件与错误处理约定。它最适合需要干净起步模板的后端工程师，尤其重视可维护目录结构、分层架构（API → services → repositories）与可预测的可扩展性。
fastapi-templates 可以帮你构建什么
使用 fastapi-templates 快速生成完整项目脚手架，包含清晰的 app/ 布局、版本化路由、Pydantic schemas，以及将业务逻辑与数据访问分离的结构。
最适合的用户与任务目标
该技能适合希望获得可复用 FastAPI 起步模板的开发者，偏好 async-first 规范，且更看重结构化蓝图而非单文件 demo。
相比通用 FastAPI 提示的差异点
fastapi-templates 强调一致的项目布局、使用 Depends 的依赖注入，以及生产环境式的关注点分离，而不是临时拼凑的端点示例。
不适合使用 fastapi-templates 的场景
如果你只需要极简 PoC 或单一端点，完整结构反而会拖慢你。
如何使用 fastapi-templates 技能
fastapi-templates 安装与调用
安装并调用：
npx skills add https://github.com/wshobson/agents --skill fastapi-templates
让 fastapi-templates 工作更好的输入
提供 API 范围、数据存储选择（如 PostgreSQL、MongoDB）、同步或异步偏好，以及预计的高层领域模块（users、auth、items）。
将粗略目标变成强提示
弱： “Create a FastAPI project.”
强： “Create a FastAPI project scaffold for a multi-tenant SaaS. Use async, PostgreSQL, versioned API routes, and a user/auth module. Include api/v1/endpoints, services, repositories, schemas, and DI with Depends.”
fastapi-templates 的建议使用流程
- 用清晰的架构说明运行技能。
- 查看生成的
app/目录树，并按领域调整命名。 - 在确认路由布局后，再添加真实模型与依赖 wiring。
优先阅读的仓库文件
先看 SKILL.md，了解预期的项目结构与依赖注入模式。
提升输出质量的实用技巧
- 明确数据库类型，让脚手架选择正确的 async 库。
- 列出核心模块（users、auth、items），以塑造 endpoints 目录结构。
- 如果预期 API 演进，明确要求版本化路由（
api/v1）。
fastapi-templates 技能 FAQ
fastapi-templates 用于 API 开发还是仅用于脚手架？
它主要用于快速、结构化脚手架。业务逻辑与持久化仍需你自行实现。
新手可以使用 fastapi-templates 技能吗？
可以，但需要具备 FastAPI 基础。该布局比教程更进阶，默认你熟悉 DI 和 schemas。
fastapi-templates 与通用 FastAPI 提示相比如何？
通用提示往往生成单文件 demo。此技能更强调生产级结构、清晰分层与目录约定。
如果我的项目是同步的怎么办？
你可以要求同步模式，但该技能对 async FastAPI 与高性能 API 场景优化更好。
如何改进 fastapi-templates 技能
提前给出领域驱动模块
列出具体模块（users、auth、billing、inventory）。这样生成的脚手架更贴合真实领域，减少后续重构。
明确数据层约束
说明 PostgreSQL vs MongoDB、ORM vs raw SQL、以及 async 驱动。这会影响 repositories 与数据库配置应落在哪些位置。
防止过度脚手架化
如果 MVP 很小，明确要求更轻量布局（如省略 repositories 或 services），避免不必要的复杂度。
首次脚手架后迭代
查看生成的目录树，再提出定向修改，例如“合并 repositories 和 services”或“现在就加 api/v2”。
常见失败模式需避免
- 需求过于模糊会产出泛化结构。
- 不命名模块会导致占位文件。
- 忽略 DI 模式会造成后续依赖 wiring 不一致。
fastapi-templates 输出质量提升指南
在提示中加入简短的“架构规则”：例如 “Pydantic schemas in schemas/, models in models/, DI in dependencies.py, and all endpoints under api/v1/endpoints/.”