用途:该技能用于搭建生产级 FastAPI 后端,结合 SQLModel 做数据库与 API 模型、集成 Dapr 以及 JWT 认证,适合以 Neon PostgreSQL 为存储构建 REST API 的场景。
主要能力:覆盖 SQLModel 的 table 模型与读写模型拆分、异步数据库引擎与会话依赖、CRUD 端点(创建、查询、更新,含 404 处理)、基于 JWKS 的 JWT 校验(RS256)、Dapr 的发布订阅(订阅发现端点与 CloudEvent 处理、发布事件)、Dapr Jobs API(alpha)定时任务、结构化日志(structlog)、Repository 与 Service 分层及依赖注入、异步测试(pytest + httpx AsyncClient)。还附带项目结构示例与 components 目录(pubsub.yaml、statestore.yaml)。
使用方式:项目初始化可用 uv init backend && cd backend,随后 uv add fastapi sqlmodel pydantic httpx python-jose uvicorn;开发运行 uv run uvicorn main:app --reload --port 8000;带 Dapr sidecar 时 dapr run --app-id myapp --app-port 8000 -- uvicorn main:app。可通过 python3 scripts/verify.py 校验,预期输出 ✓ scaffolding-fastapi-dapr skill ready;若失败需检查 references/ 下两个模式文件是否存在。
限制:资料未提供收费、价格、平台支持范围等细节;Dapr Jobs API 标注为 alpha,回调与调度细节以官方为准;示例中的数据库连接、SSO 地址、Dapr 端口等需按实际环境替换,暂未提供其他约束说明。