FastAPI 路由构建助手
帮助 Python 开发者按规范创建带认证和 CRUD 的 FastAPI 路由。
技能仅提供FastAPI代码模板，不含凭据窃取、隐蔽外传或恶意行为，且展示了认证依赖；但列表和详情端点默认允许匿名访问，所有权校验被注释为可选，删除端点未实际校验所有权，也没有敏感数据、确认、回滚或数据流披露，因此扣分。
说明、模板和参考文件基本一致，涵盖认证、状态码、分页及异步I/O注意事项；但模板依赖未给出的项目模块，服务实例每请求直接创建且未展示生命周期管理，异常路径、并发、验证失败和可诊断反馈覆盖不足。静态审查下按上限不超过10，故为8分。
目标场景和触发条件较清楚，适合在已有FastAPI项目中生成CRUD路由；但输入前提、非适用边界、项目结构差异、权限模型和中文环境支持未说明，模板假定固定app包布局，语义适配证据有限。
SKILL.md结构简洁，提供快速开始、分层参考文件、集成步骤、许可证和版本元数据；但缺少安装依赖、参数约定、完整示例、FAQ、已知限制、变更记录和明确维护更新路径。仓库提供MIT许可证及官方组织来源，但不能补足技能文档缺口。
模板可直接作为CRUD路由起点，包含Pydantic响应模型、分页、认证依赖和基本404处理；但仍需替换占位符并创建模型、服务、挂载和前端函数，所有权保护未完成，删除和权限语义可能需要较多人工修订，因此仅支持核心任务且直接可用性有限。静态审查下最高不超过7，故为6分。
技能文件、模板和能力清单可审计，仓库还显示存在通用CI和测试基础设施；但提供的材料没有针对该技能的提交测试、真实生成样例或第三方执行结果，无法独立复现关键路径。静态审查下最高不超过5，故为4分。
- 模板中的“需要认证和所有权”与实际代码不一致：更新仅检查资源存在，删除完全未检查所有权；部署前必须按项目授权模型补充强制校验。
- 列表和详情接口使用可选认证，可能意外暴露资源；应明确公开/私有语义并配置最小权限。
- 技能假定app.auth、app.models和app.services等固定模块及异步服务方法，复制前需核对项目结构、依赖版本和资源生命周期。
- 仓库级CI和测试材料未证明该技能关键路径已执行验证。
它能做什么 & 适用场景
这是一个面向 FastAPI 应用的 Python Agent Skill，用于创建 REST API 路由。它覆盖 CRUD 操作、可选或必需的认证依赖、响应模型和 HTTP 状态码。Skill 提供可复制的路由模板占位符以及项目集成步骤。适合希望统一路由结构和 API 返回约定的后端项目，但它不是完整的 FastAPI 教程或独立运行工具。
它指导开发者从 assets/template.py 复制路由模板，并替换资源名称占位符；生成包含 CRUD 操作、认证依赖、响应模型和 HTTP 状态码的 FastAPI 路由；建议将路由放入 src/backend/app/routers/，在 src/backend/app/main.py 中挂载，并补充 Pydantic 模型、服务层和前端 API 函数；同时提示根据异步 I/O 选择 def 或 async def，并通过 lifespan 管理长期资源。
- 后端开发者为项目资源创建一组标准化的 FastAPI CRUD 端点。
- 团队需要为部分路由添加可选登录用户或必需登录用户依赖时。
- 开发者希望为 GET、POST 和 DELETE 端点明确声明响应模型与 HTTP 状态码时。
- 维护已有 FastAPI 项目并将新路由接入统一目录、主应用和服务层时。
优缺点一览
- 覆盖 CRUD、认证依赖、响应模型和常用 HTTP 状态码等核心路由模式。
- 提供模板占位符和明确的项目集成路径，便于快速开始。
- 明确区分同步与异步端点，并强调避免在 async 处理器中执行阻塞 I/O。
- MIT 许可，作者标注为 Microsoft。
- 内容聚焦路由结构，没有提供完整的数据库、认证实现或服务层代码。
- 依赖的 FastAPI 和 Pydantic 版本未说明。
- 源材料没有展示该单个技能的测试覆盖或具体验收场景。
- 没有提供独立安装命令，安装流程面向整个技能仓库集合。
如何安装
安装整个仓库的技能集合：npx skills add microsoft/skills。根据向导选择需要的技能；技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/。源材料没有提供该单个技能的独立安装命令，也没有说明 FastAPI 或 Pydantic 的安装命令。
如何使用
在兼容 Agent Skills 的编码代理中提出类似请求：“请为 Project 创建一个 FastAPI CRUD router，使用必需认证依赖、Pydantic 响应模型，并返回正确的 HTTP 状态码。”代理应参考 assets/template.py，将 {{ResourceName}}、{{resource_name}} 和 {{resource_plural}} 替换为对应名称，并完成路由挂载及相关模型或服务层集成。