ForgeFlow Platform：企业级多智能体协作开发平台的技术演进

ForgeFlow Platform是面向企业级场景的多智能体协作开发控制平面平台，支持任务编排、Worker运行时、Trae网关自动化和代码审查工作流。项目已完成从MCP-only阶段到核心平台的演进，具备完整的调度器、状态管理、持久化和灾备能力，为企业构建AI Agent平台提供工程化实现参考。

项目概述

ForgeFlow Platform是专为多智能体协作开发设计的控制平面平台，涵盖任务调度、Worker运行时管理到代码审查工作流的全链路能力，已具备生产环境所需的稳定性、可观测性和灾备能力。

架构设计

• 控制平面与Worker分离：Dispatcher作为真相源，控制层负责任务编排，Worker层仅接入AI模型/工具，确保可扩展性；
• Trae-First策略：优先收敛Trae无人值守链路稳定性，再扩展其他Worker能力，避免多线并行质量问题。

阶段一：TypeScript化重构

完成分散脚本到统一TypeScript架构迁移，核心组件（worker-daemon、dispatcher等）基于TypeScript基础层，提升可维护性与类型安全性。

阶段二：持久化与状态管理

• SQLite真相源：默认使用SQLite存储，支持JSON回退；
• 状态机设计：覆盖任务完整生命周期（planned→ready→assigned→in_progress→终态），支持blocked态与依赖门控；
• 跨进程同步：文件锁机制处理状态竞争，超时返回503；
• 结构化查询：支持投影路径查询与一致性核对。

阶段三：核心平台能力

• Lease机制：冲突检测、过期回收与指标聚合；
• Shadow Path：Postgres/queue影子路径，SQLite仍为真相源；
• 只读降级：写入操作返回503，查询可用；
• 灾备工具：备份/恢复脚本与阶段三验证入口。

Trae自动化链路

• 任务物化：独立worktree避免串味；
• 结构化规范：自动渲染prompt并持久化；
• 分支管理：复用分支条件严格，否则新建-rN分支；
• 会话隔离：收窄聊天根节点，检测旧任务污染；
• 结果验证：远端分支HEAD与commit SHA一致才标记review_ready。

Generic Worker Daemon

• 显式副作用路径；
• 环境变量白名单；
• 自动PR需显式启用；
• 重试失败记为failed。

MCP包

packages/mcp-*提供标准工具（调度、审查、GitHub、仓库策略等），业务逻辑在dispatcher层。

可观测性

• 核心指标：queueDepth、plannedTasks、avgAssignmentLagMs等；
• 失败信号：submitResultRetryCount、stateLockTimeoutCount等；
• 事件追踪：traceId关联全链路，worker回写phase events；
• SLO与灾备：/api/slo读取burn-rate，/api/dr/status读取灾备状态。

安全合规

• 敏感字段redact；
• 审查决策支持merge/block/rework等，保留原始决策用于审计；
• 元数据校验，不合法拒绝。

部署入口

• 控制平面：start-control-plane.sh；
• 服务：dispatcher-server、trae-automation-gateway/worker等；
• 审查决策：submit-review-decision.js。

参考部署

• Docker Compose：deploy/compose/*；
• Kubernetes Helm Chart：deploy/helm/forgeflow/*。

文档体系

• 规则入口：AGENTS.md；
• 导航入口：docs/README.md；
• 稳定文档：ARCHITECTURE.md、API_ENDPOINTS.md等；
• 运维手册：runbooks/*。

ForgeFlow Platform构建了完整的企业级多智能体协作基础设施，核心特性包括：

1. 可靠性：SQLite真相源、状态机与跨进程锁；
2. 可观测性：全链路指标与事件追踪；
3. 可扩展性：Worker抽象与MCP协议；
4. 安全性：敏感信息保护与审计；
5. 灾备能力：备份恢复与只读降级。

建议企业级AI Agent平台团队参考其架构设计与实现细节，提升平台稳定性与可维护性。