certification-proflie

此技能作为一个综合性的项目指南模板，专为构建复杂、AI 集成应用程序的工程团队而设计。它提供了一个标准化的框架，帮助开发人员在架构决策、文件结构和编码模式上保持一致，特别适用于涉及 Next.js、FastAPI、Supabase 和 Claude API 的现代技术栈。通过将这些标准编码化，该技能可协助团队最大限度地减少技术债，简化新成员的入职流程，并确保在开发、测试和生产部署生命周期中维持一致的质量。

• 标准化的架构概览：整合了前端 (Next.js 15, TypeScript)、后端 (FastAPI, Python) 和数据库 (Supabase) 配置，以确保系统级的一致性。

• 最佳实践编码模式：包含用于结构化 API 响应、前端数据获取 Hook 以及强大的 Claude AI 结构化输出集成之可重用实现。

• 系统化测试需求：定义了使用 Playwright 进行端到端测试、使用 pytest 进行单元/集成测试以及覆盖率报告的明确协议。

• 部署与维护流程：记录了 Google Cloud Run 的部署策略和配置管理，以促进可靠的生产版本发布。

• 可扩展的项目模板：作为可适应任何软件项目的基础，允许团队注入其特定的限制和模式。

• 适用于需要在大规模或多服务代码库中强制执行一致性的软件架构师与首席开发人员。

• 在启动新项目模块、引导新团队成员或进行架构审查时使用此技能。

• 输入通常包括项目需求与技术限制；输出则是已建立的编码标准与系统设计文档。

• 限制：使用者必须根据当前的存储库状态维护文档，以确保其保持为可靠的唯一真实来源。

• 确保所有架构决策皆附有架构决策记录 (ADR)，以追踪系统随时间的演变。