skills

此技能为 AI 驱动的全栈应用程序提供了一个完整的生产级基础。它以 Zenith 平台为模板，为架构一致性、代码模式和开发工作流程建立了严格的标准。适用于希望使用 Next.js 15 (App Router)、TypeScript、FastAPI (Python) 和 Supabase 强大技术栈快速启动项目的软件工程师与 AI 开发者。该模板涵盖了端到端的集成，确保前端组件与后端服务通过类型安全接口稳定通讯。

• 包含详细服务图表与技术栈定义的全栈架构总览。

• 预先配置的目录结构，区分前端组件、hooks、后端路由、服务层与数据库模型。

• 使用 Pydantic (后端) 与 TypeScript 接口 (前端) 的标准化 API 响应模式。

• Claude API 集成模式，具备结构化工具调用、Pydantic 模式验证与 JSON 输出管理。

• 完整的测试模式，包含 Playwright (E2E)、pytest (后端) 与 React Testing Library (组件测试)。

• 适用于 Google Cloud Run 与 Vercel 的部署配置。

• 在启动新模块或全栈功能时，使用此技能来强化团队成员间的开发一致性。

• 遵循提供的目录结构，以确保项目扩展时的可维护性。

• 在构建需要确定性 JSON 响应的 LLM 代理时，参考提供的 Claude 结构化输出示例。

• 通过使用提供的 ApiResponse 类处理所有内部与外部通讯，确保后端数据整合性。

• 实现建议的自定义 React hooks，以便在 Next.js 工作区中高效管理异步状态与数据获取。