用途：当前端代理需要准确的 API 负载结构时，把本地 FastAPI OpenAPI 文件同步为 TypeScript 类型；对 Firebase 项目则读取 Firestore 规则或 schema 提示。
使用前提：项目根目录存在本地 OpenAPI 文件（openapi.json，优先使用脚手架生成的文件）；Firebase 项目存在 Firestore 规则或 schema 文件。若 API 正在运行而文件缺失或过期，需先导出到磁盘，不要把 URL 传入本技能：curl -fsS http://127.0.0.1:8090/openapi.json -o openapi.json
主要能力与用法：FastAPI 类型：python scripts/sync_openapi.py --project-root <root>，仅依据本地 openapi.json 写出 src/types/api.ts，可选 --openapi 指定路径或相对 JSON。Firebase：python scripts/fetch_firestore_schema.py --project-root <root>。在 composables 中导入生成的类型，不要猜测字段名；若 OpenAPI 大量使用 $ref，可细化生成的接口。
限制：仅处理本地文件，不接受 URL；不支持 FastAPI、Firebase 之外的来源；未提供除上述命令外的配置、收费、平台或效果信息。