用途
该技能适用于需要完成全栈功能开发与编排的场景,覆盖后端、前端和基础设施三个层面。它采用 API 优先(API-first)的开发方式,以 API 规范驱动后端实现与前端消费,强调契约驱动开发、关注点分离、完整测试与可上生产的部署。当任务与“全栈编排全栈功能”无关,或需要该范围之外的其它领域或工具时,不适合使用该技能。
主要能力
技能将全栈功能交付拆分为四个阶段:
第一阶段:架构与设计基础
- 数据库架构设计:设计数据库模式与数据模型,考虑可扩展性、查询模式、索引策略与数据一致性,必要时包含迁移策略,产出逻辑与物理数据模型。
- 后端服务架构:基于上一步数据库设计,划分服务边界,定义 API 契约(OpenAPI/GraphQL),设计认证与授权策略,指定服务间通信模式,包含熔断、重试等韧性模式与缓存策略。
- 前端组件架构:基于 API 契约设计组件层级、状态管理方案(Redux/Zustand/Context)、路由结构与数据获取模式,包含无障碍要求与响应式设计策略,并规划 Storybook 组件文档。
第二阶段:并行实现
- 后端服务实现:按架构与 API 规范构建 RESTful/GraphQL 端点,包含校验、错误处理与日志,实现业务逻辑、数据访问层、认证中间件与外部服务集成,并加入结构化日志、指标与追踪。
- 前端实现:构建 React/Next.js 组件,实现状态管理、API 集成(含错误处理与加载状态)、表单校验与响应式布局,编写 Storybook 故事,确保符合 WCAG 2.1 AA 无障碍要求。
- 数据库实现与优化:编写迁移脚本、必要时编写存储过程,优化后端识别出的查询,建立索引并实现数据校验约束,包含数据库级安全措施与备份策略。
第三阶段:集成与测试
- API 契约测试:使用 Pact/Dredd 验证前后端之间的 API 契约,对所有端点编写集成测试,测试认证流程、验证错误响应与 CORS 配置,并包含负载测试场景。
- 端到端测试:使用 Playwright/Cypress 覆盖关键用户旅程、跨浏览器兼容性、移动端响应式与错误场景,测试特性开关集成、分析跟踪与性能指标,并包含视觉回归测试。
- 安全审计与加固:审查 API 安全(认证、授权、限流),检查 OWASP Top 10 漏洞,审计前端 XSS/CSRF 风险,验证输入清理与密钥管理,给出渗透测试结果与修复步骤。
第四阶段:部署与运维
- 基础设施与 CI/CD:创建 Docker 容器、Kubernetes 清单或云平台配置,实现带自动化测试门禁的 CI/CD 流水线,配置特性开关(LaunchDarkly/Unleash)与监控告警,包含蓝绿部署策略与回滚流程。
- 可观测性:搭建分布式追踪(OpenTelemetry)、应用指标(Prometheus/DataDog)、集中式日志(ELK/Splunk),创建关键指标看板,定义 SLI/SLO,包含告警规则与值班流程。
- 性能优化:分析并优化数据库查询,实施缓存策略(Redis/CDN),优化前端包体积与加载性能,配置懒加载与代码分割,调优后端服务性能,并给出前后对比指标。
配置选项
- stack:指定技术栈,例如“React/FastAPI/PostgreSQL”“Next.js/Django/MongoDB”。
- deployment_target:云平台(AWS/GCP/Azure)或本地部署。
- feature_flags:启用/禁用特性开关集成。
- api_style:REST 或 GraphQL。
- testing_depth:全面或必要。
- compliance:特定合规要求(GDPR、HIPAA、SOC2)。
成功标准
- 所有 API 契约通过契约测试验证
- 前后端集成测试通过
- E2E 测试覆盖关键用户旅程
- 安全审计通过且无严重漏洞
- 性能指标满足既定 SLO
- 可观测性体系捕获所有关键指标
- 特性开关已配置以支持渐进式发布
- 所有组件文档完整
- CI/CD 流水线具备自动化质量门禁
- 已验证零停机部署能力
协作说明
- 每个阶段都建立在前一阶段的产出之上
- 第二阶段中的并行任务可同时运行,但必须在第三阶段汇合
- 保持需求与实现之间的可追溯性
- 在所有服务间使用关联 ID 以支持分布式追踪
- 在 ADR 中记录所有架构决策
- 确保各服务间的错误处理与 API 响应保持一致
限制
该技能资料中未提供具体的技术栈默认值、价格、收费方式以及实际使用效果等细节,这些信息暂未提供。使用时需自行提供待实现的功能描述(即 $ARGUMENTS 对应的内容)。