Framework Orchestrator

框架编排器

概述

框架编排器是一项元技能，可在整个项目生命周期中协调所有其他技能和框架。它会分析项目、识别适用的模式，并按最佳顺序安排框架和技能。

**可以把它看作：**了解何时应用何种方法论的 AI 项目经理。

何时使用此技能

在以下情况下使用框架编排器：

• 启动新项目，需要方法论方面的指导
• 不确定应先应用哪些框架或技能
• 希望获得完整的项目编排计划
• 需要了解项目的复杂度模式
• 在不同项目阶段之间转换
• 并行管理多个工作流

主要能力

• 分析项目并识别复杂度模式（A、B、C）
• 推荐最佳框架顺序
• 在适当阶段协调技能启用
• 提供阶段关卡验证
• 根据项目演进调整编排
• 确保全面覆盖所有维度

工作流

第 1 步：识别模式

分析项目，并将其归为以下三种模式之一：

模式 A：简单功能/增强

特征：

• 在现有系统上添加内容
• 需求明确
• 风险低，安全影响极小
• 单个团队，周期短（几天到 1–2 周）

示例：

• 为现有搜索添加筛选器
• 新增仪表板小组件
• 添加表单字段
• 更新 UI 样式

**周期：**1–5 天

---

模式 B：新产品/系统

特征：

• 从头构建或开发主要模块
• 需要用户验证
• 安全/合规性至关重要
• 需要考虑多个方面（UX、架构、测试）
• 周期中等（几周到几个月）

示例：

• 新的 SaaS 产品
• 客户门户
• 内部工具
• API 平台

**周期：**4–12 周

---

模式 C：AI 原生/复杂系统

特征：

• 具备模式 B 的所有特征，此外还包括：
• AI Agent、RAG 系统或知识图谱
• 复杂的编排
• 新颖的技术
• 更高的不确定性和更多迭代

示例：

• 多 Agent AI 系统
• RAG 驱动的知识库
• 智能自动化平台
• AI 辅助决策支持

**周期：**8–20 周

---

第 2 步：选择框架

根据模式推荐框架顺序：

模式 A 顺序（简单功能）

1. simple_feature_framework - 轻量级需求与验证
2. code-quality-enforcer - 确保代码符合标准
3. testing-strategist - 单元测试覆盖率
4. deployment-advisor - 快速发布

协调技能：

• quality-assurance（测试）
• performance-optimizer（如有需要）

---

模式 B 序列（新产品）

阶段 1：探索与验证

• discovery_validation_framework - 用户研究与问题验证
• product_market_fit_framework - 市场分析与定位
• prp-generator 技能 - 创建产品需求提示词
• user-researcher 技能 - 开展用户访谈

阶段 2：架构与设计

• bmad-method 技能 - 业务模型与架构对齐
• design_prototyping_framework - 线框图与原型
• ux-designer 技能 - 绘制用户旅程图
• security-architect 技能 - 威胁建模与安全设计
• api-designer 技能（如适用）- API 契约设计

阶段 3：开发

• full_stack_dev_framework - 实施指导
• frontend-builder / api-designer 技能 - 构建 UI 和后端
• quality-assurance 技能 - 代码质量与测试

阶段 4：测试与验证

• testing_validation_framework - 全面的测试策略
• quality-assurance 技能 - 执行测试金字塔
• usability-tester 技能 - 用户验收测试
• security-architect 技能 - 安全测试

阶段 5：部署与发布

• deployment_devops_framework - CI/CD 和基础设施
• deployment-advisor 技能 - 部署策略
• go-to-market-planner 技能 - 发布规划

---

模式 C 序列（AI 原生）

包含模式 B 的所有阶段，另外还包括：

阶段 2b：AI 架构（与标准架构并行）

• multi-agent-architect 技能 - Agent 系统设计
• rag-implementer 技能 - RAG 架构（如适用）
• knowledge-graph-builder 技能 - 知识结构（如适用）
• agentic-workflow-orchestration-framework - Agent 协调

阶段 3b：AI 开发（与标准开发集成）

• context_engineering_framework - 提示词与上下文设计
• multi_agent_orchestration_framework - Agent 实施

阶段 4b：AI 测试（额外的测试层）

• 测试 Agent 行为和边缘情况
• 验证 RAG 检索质量
• 对大模型性能进行基准测试

---

第 3 步：阶段编排

通过验证关卡执行各阶段：

阶段关卡结构

进入阶段 2（设计）：

• PRP 文档已完成
• 问题陈述已验证
• 成功指标已定义
• 用户故事已记录

进入阶段 3（开发）：

• 架构已记录
• 数据模型已设计
• 安全威胁已识别
• 缓解措施已规划

进入阶段 4（测试）：

• 功能已完成
• 单元测试覆盖率 >80%
• 代码审查已通过
• SAST 扫描无问题

进入阶段 5（部署）：

• 所有测试均已通过
• UAT 已完成
• 安全测试已完成
• 覆盖率 >90%

---

第 4 步：技能协调

根据当前阶段编排技能：

探索阶段技能：

• user-researcher
• product-strategist
• product-analyst

设计阶段技能：

• ux-designer
• design-system-architect
• bmad-method
• security-architect

开发阶段技能：

• frontend-builder
• api-designer
• multi-agent-architect（模式 C）
• rag-implementer（模式 C）
• mvp-builder

测试阶段技能：

• quality-assurance
• usability-tester
• security-architect

部署阶段技能：

• deployment-advisor
• go-to-market-planner
• performance-optimizer

发布后技能：

• product-analyst
• customer-feedback-analyzer
• performance-optimizer

---

示例

示例 1：SaaS 分析平台（模式 B）

项目分析：

• 从零开始打造新产品
• B2B SaaS 模式
• 安全与合规至关重要
• 周期为 8 周

推荐顺序：

第 1 周：探索

1. discovery_validation_framework
2. user-researcher skill → 用户访谈
3. product-strategist skill → 市场验证
4. prp-generator skill → 创建 PRP

第 2 周：架构 5. bmad-method skill → 业务模式与架构对齐 6. design_prototyping_framework → 线框图 7. ux-designer skill → 用户旅程 8. api-designer skill → API 设计 9. security-architect skill → 威胁模型

第 3-6 周：开发 10. full_stack_dev_framework 11. frontend-builder skill → 构建 React UI 12. api-designer skill → 构建后端 13. quality-assurance skill → 持续测试

第 7 周：测试 14. testing_validation_framework 15. quality-assurance skill → 测试金字塔 16. usability-tester skill → 用户测试 17. security-architect skill → 安全测试

第 8 周：部署 18. deployment_devops_framework 19. deployment-advisor skill → 部署到生产环境 20. go-to-market-planner skill → 发布计划

---

示例 2：多 Agent 客户支持系统（模式 C）

项目分析：

• 采用多个 Agent 的 AI 原生系统
• 使用 RAG 检索知识
• 编排复杂
• 周期为 12 周

推荐顺序：

第 1-2 周：探索（与模式 B 相同）

第 3-4 周：架构

• bmad-method skill
• security-architect skill
• multi-agent-architect skill → Agent 系统设计
• rag-implementer skill → RAG 架构
• knowledge-graph-builder skill → 知识结构
• agentic-workflow-orchestration-framework

第 5-9 周：开发

• full_stack_dev_framework
• frontend-builder skill
• multi-agent-architect skill → Agent 实现
• rag-implementer skill → 向量数据库 + 嵌入
• context_engineering_framework → 提示词设计
• quality-assurance skill

第 10-11 周：测试

• testing_validation_framework
• quality-assurance skill
• 测试 Agent 行为、RAG 质量和大模型性能
• usability-tester skill

第 12 周：部署

• deployment_devops_framework
• deployment-advisor skill
• go-to-market-planner skill

---

示例 3：添加用户导出功能（模式 A）

项目分析：

• 对现有系统进行增强
• 需求清晰
• 复杂度低
• 周期为 3 天

推荐顺序：

第 1 天：

1. simple_feature_framework → 定义需求
2. api-designer skill → 设计导出端点

第 2 天： 3. 构建后端 + 前端 4. quality-assurance skill → 单元测试

第 3 天： 5. testing-strategist skill → 集成测试 6. deployment-advisor skill → 部署到预发布环境，再部署到生产环境

---

最佳实践

1. 始终从识别模式开始

不要急于使用框架。首先了解：

• 范围（简单功能、新产品、AI 系统）
• 时间线（天、周、月）
• 风险（低、中、高）

2. 遵守阶段关卡

不要跳过验证检查点。每个关卡都能确保：

• 前序工作已完成
• 下一阶段具备适当的基础
• 风险已识别并得到缓解

3. 尽可能并行推进

有些工作可以并行开展：

• UX 设计 + 架构设计（第 2 阶段）
• 前端 + 后端开发（第 3 阶段）
• 编写测试 + 开发功能（第 3 阶段）

4. 根据实际情况调整编排

如果项目发生变化：

• 模式 A → 模式 B：增加探索和设计阶段
• 模式 B → 模式 C：增加 AI 架构和测试
• 缩减范围：简化编排

5. 协调技能，避免负担过重

不要一次性启用所有技能。应按顺序安排：

• 每个阶段最多使用 1-3 项技能
• 明确技能之间的交接
• 每项技能都有特定的交付成果

---

常见陷阱

1. 误判模式

反模式： 将模式 B（新产品）误当作模式 A（简单功能） 结果： 跳过需求探索，做出错误的东西

修正： 只要存在任何不确定性，就默认采用模式 B

2. 跳过阶段

反模式： 不做设计，直接进入开发 结果： 返工、遗漏需求、安全漏洞

修正： 遵循阶段顺序，验证阶段门

3. 对简单功能过度编排

反模式： 只改按钮颜色，却使用完整的模式 B 编排流程 结果： 在不必要的流程上浪费时间

修正： 对于真正简单的工作，模式 A 是合适的

4. 对复杂项目编排不足

反模式： 未经过适当的架构阶段就构建 AI 系统 结果： 技术债务、性能不佳、推倒重来

修正： 模式 C 需要全面的编排

5. 忽视阶段门

反模式： 架构尚未完善就进入开发阶段 结果： 基础不牢，开发中途遇到阻碍

修正： 严格执行阶段门，并记录就绪情况

---

相关技能

• prp-generator - 创建需求（由编排器在第 1 阶段调用）
• bmad-method - 业务与架构对齐（第 2 阶段）
• security-architect - 安全设计（第 2 和第 4 阶段）
• quality-assurance - 测试策略（第 3 和第 4 阶段）
• deployment-advisor - 基础设施（第 5 阶段）
• 所有其他技能 - 由编排器在适当阶段激活

---

交付成果

使用 Framework Orchestrator 时，需产出：

1. 模式识别

   • 模式：A、B 或 C
   • 分类依据
   • 预计时间线

2. 编排计划

   • 阶段划分
   • 框架顺序
   • 技能激活节点
   • 阶段门标准

3. 当前阶段状态

   • 当前所处阶段
   • 完成百分比
   • 阶段门标准就绪情况
   • 后续步骤

4. 风险与调整计划

   • 已识别的风险
   • 应急计划
   • 何时调整编排

---

成功指标

成功的编排意味着：

• 识别出正确的模式（没有误分类）
• 按最佳顺序应用框架
• 阶段门得到执行并通过
• 在适当时机激活技能
• 不会因跳过阶段而导致重大返工
• 团队清楚当前阶段和后续步骤
• 项目交付质量与模式要求相符

---

请记住： 编排器确保你在正确的时间应用正确的方法。它决定了开发是井然有序，还是混乱无序。