全栈特性编排

---

name: full-stack-orchestration-full-stack-feature description: "用于全栈编排全栈功能开发" risk: unknown source: community date_added: "2026-02-27"

适用场景

• 处理全栈编排全栈功能相关的任务或工作流
• 需要全栈编排全栈功能的指导、最佳实践或检查清单

不适用场景

• 任务与全栈编排全栈功能无关
• 需要此范围之外的其他领域或工具

使用说明

• 明确目标、约束条件和所需输入。
• 应用相关最佳实践并验证结果。
• 提供可操作的步骤和验证方法。
• 如需详细示例，请打开 resources/implementation-playbook.md。

使用现代 API 优先方法，跨后端、前端和基础设施层编排全栈功能开发：

[扩展思考：此工作流协调多个专业化代理，从架构到部署交付完整的全栈功能。它遵循 API 优先开发原则，确保契约驱动开发，其中 API 规范驱动后端实现和前端消费。每个阶段都建立在前一阶段的输出之上，创建一个具有适当关注点分离、全面测试和生产就绪部署的内聚系统。工作流强调现代实践，如组件驱动的 UI 开发、功能标志、可观测性和渐进式发布策略。]

阶段 1：架构与设计基础

1. 数据库架构设计

• 使用 Task 工具，subagent_type="database-design::database-architect"
• 提示："为以下内容设计数据库模式和数据模型：$ARGUMENTS。考虑可扩展性、查询模式、索引策略和数据一致性要求。如果修改现有模式，包含迁移策略。提供逻辑和物理数据模型。"
• 预期输出：实体关系图、表模式、索引策略、迁移脚本、数据访问模式
• 上下文：初始需求和业务领域模型

2. 后端服务架构

• 使用 Task 工具，subagent_type="backend-development::backend-architect"
• 提示："为以下内容设计后端服务架构：$ARGUMENTS。使用上一步的数据库设计，创建服务边界，定义 API 契约（OpenAPI/GraphQL），设计认证/授权策略，并指定服务间通信模式。包含弹性模式（断路器、重试）和缓存策略。"
• 预期输出：服务架构图、OpenAPI 规范、认证流程、缓存架构、消息队列设计（如适用）
• 上下文：步骤 1 的数据库模式、非功能性需求

3. 前端组件架构

• 使用 Task 工具，subagent_type="frontend-mobile-development::frontend-developer"
• 提示："为以下内容设计前端架构和组件结构：$ARGUMENTS。基于上一步的 API 契约，设计组件层次结构、状态管理方案（Redux/Zustand/Context）、路由结构和数据获取模式。包含可访问性要求和响应式设计策略。规划 Storybook 组件文档。"
• 预期输出：组件树图、状态管理设计、路由配置、设计系统集成计划、可访问性检查清单
• 上下文：步骤 2 的 API 规范、UI/UX 需求

阶段 2：并行实现

4. 后端服务实现

• 使用 Task 工具，subagent_type="python-development::python-pro"（或根据技术栈选择 "golang-pro"/"nodejs-expert"）
• 提示："为以下内容实现后端服务：$ARGUMENTS。使用阶段 1 的架构和 API 规范，构建带有适当验证、错误处理和日志记录的 RESTful/GraphQL 端点。实现业务逻辑、数据访问层、认证中间件和外部服务集成。包含可观测性（结构化日志、指标、追踪）。"
• 预期输出：后端服务代码、API 端点、中间件、后台任务、单元测试、集成测试
• 上下文：阶段 1 的架构设计、数据库模式

5. 前端实现

• 使用 Task 工具，subagent_type="frontend-mobile-development::frontend-developer"
• 提示："为以下内容实现前端应用：$ARGUMENTS。使用阶段 1 的组件架构构建 React/Next.js 组件。实现状态管理、带有适当错误处理和加载状态的 API 集成、表单验证和响应式布局。创建组件的 Storybook 故事。确保可访问性（WCAG 2.1 AA 合规）。"
• 预期输出：React 组件、状态管理实现、API 客户端代码、Storybook 故事、响应式样式、可访问性实现
• 上下文：步骤 3 的组件架构、API 契约

6. 数据库实现

• 使用 Task 工具，subagent_type="database-design::database-architect"
• 提示："实现数据库模式、迁移和种子数据：$ARGUMENTS。创建迁移脚本、索引、约束和初始种子数据。包含回滚策略。"
• 预期输出：迁移文件、种子脚本、索引定义、数据库文档