核心用法
本技能是专为 FastAPI 框架设计的深度开发指南，采用纯文档架构（22 个 Markdown 文件），无任何可执行代码。其核心价值在于情境化故障诊断：当开发者遇到「所有路由同时变慢」「422 验证错误」「307 重定向」「500 无 CORS 头」等具体问题时，可直接定位到对应子文档（如 async.md、pydantic.md、routing.md 等）获取精准解决方案。
技能覆盖六大开发阶段：
1. 编码期：路由设计、依赖注入、Pydantic v1/v2 迁移、认证授权
2. 调试期：异步阻塞诊断、数据库连接池耗尽、事件循环异常
3. 测试期：TestClient 与 AsyncClient 选择、依赖覆盖、生命周期管理
4. 优化期：性能瓶颈分析、序列化优化、分页与缓存策略
5. 部署期：Uvicorn/Gunicorn 配置、优雅关闭、容器化与健康检查
6. 安全期：SSRF 防护、批量赋值防护、安全头配置
用户可通过 ~/Clawic/data/fastapi/config.yaml 自定义 11 项偏好配置，包括 Pydantic 版本、数据库栈、认证方案、部署目标等，实现个性化代码生成。
显著优点
1. 权威性与完整性：来自 Clawic 验证技能库（T2 可信来源）， maintainer 为资深 FastAPI 贡献者 ivangdavila，内容经过实战验证
2. 情境驱动设计：非 API 参考手册式罗列，而是「症状→诊断→处方」的临床式指南，大幅降低问题定位时间
3. 生产级深度：涵盖 threadpool 槽位限制（40 slots/worker）、连接池数学（workers×15）、事件循环隔离等高级主题
4. 版本兼容性明确：标注各特性所需的 FastAPI/Pydantic/Python 最低版本，避免迁移陷阱
5. 安全零风险：纯文档型技能，无代码执行、无外部依赖、无数据收集，通过六维深度检测
潜在缺点与局限性
1. 框架专属限制：明确声明「不适用于 Django、Flask 或纯 Python 问题」，跨框架开发者需切换技能
2. 无交互式工具：纯文本指南，不包含代码生成器、脚手架 CLI 或实时诊断工具
3. 配置持久化依赖：用户偏好需手动维护于本地 YAML 文件，无云端同步能力
4. 版本滞后风险：技能版本 1.0.1 基于 FastAPI 0.111+，未来框架重大更新需等待技能同步
5. 学习曲线陡峭：预设 11 个配置维度和 20+ 子文档，新手可能面临信息过载
适合的目标群体
- 中级 Python 开发者：已掌握 FastAPI 基础，需解决性能、部署、迁移等进阶问题
- 全栈工程师：需将 FastAPI 服务从开发环境推进至生产环境，关注 worker 配置、连接池、优雅关闭
- 技术负责人：评估技术债、制定团队规范（如
defvsasync def决策规则、Pydantic v2 迁移策略） - DevOps/ SRE：排查「服务健康但客户端超时」「QueuePool limit」等生产故障
使用风险
1. 配置误用风险：--reload 与 --workers 同时使用时 workers 被静默忽略，技能已警告但用户仍可能忽视
2. 迁移断层风险：Pydantic v1→v2 的 API 更名（model_dump vs .dict()）若配置错误，生成代码将直接报错
3. 环境假设风险：部分建议基于 Linux 容器环境（如 gunicorn-uvicorn），Windows 原生部署需额外适配
4. 安全建议依赖：security.md 中的防护清单需人工逐项核对，技能本身不强制执行
5. 无自动更新机制：技能版本固定于 1.0.1，FastAPI 生态演进后可能产生最佳实践偏差