Cascade：开源AI代理编排平台，实现从需求到合并的全自动软件开发生命周期

Cascade是一个开源平台，能够自动化整个软件开发生命周期。它支持Claude Code、Codex、opencode和LLMist等多种AI代理引擎，通过双角色GitHub模型和11种专业代理类型，实现从PM卡片到代码合并的全流程自动化。

Cascade的定位非常明确：它不是一个单一的AI工具，而是一个编排多个AI代理的指挥平台。项目的核心理念可以用一条简单的流水线概括：

PM卡片 → 拆分 → 规划 → 实现 → 提交PR → 审查 → 迭代 → 合并

这意味着，当你把项目管理工具（如Trello或Jira）与GitHub仓库连接后，Cascade可以自动驱动工作项从计划阶段一路走到代码合并，无需人工干预每一个中间步骤。

Cascade的一个显著特点是其可插拔的代理引擎架构。它不会将你锁定在某一个AI供应商，而是支持多种主流AI编程工具：

• Claude Code（默认引擎，基于Anthropic的Claude Code SDK）
• Codex（OpenAI的Codex CLI）
• opencode（OpenCode服务器）
• LLMist（支持OpenRouter、Anthropic、OpenAI等多种后端）

这种设计让用户可以根据项目需求、成本考量或性能偏好自由切换底层AI引擎，而无需改变工作流程。

Cascade内置了11种专门的代理类型，每种代理负责生命周期中的特定环节：

代理类型	触发条件	职责描述
拆分代理	PM状态变更	将大型需求卡片拆分为更小的工作项
规划代理	PM状态变更	在卡片上创建详细的实现计划
实现代理	PM状态变更	编写代码并提交Pull Request
审查代理	CI通过/PR创建/审查请求	审查Pull Request的代码质量
响应审查代理	审查者请求修改	处理代码审查反馈
响应CI代理	CI构建失败	诊断并修复失败的CI检查
响应PR评论代理	PR收到评论	回应Pull Request上的评论
调试代理	会话日志上传	分析代理会话日志并创建调试卡片
解决冲突代理	检测到合并冲突	自动解决Git合并冲突
待办管理代理	定时/手动触发	管理和优先排序待办事项

这种分工明确的架构模拟了一个真实的开发团队：有人负责需求分析，有人负责编码，有人负责代码审查，有人负责处理反馈。

Cascade采用了一个非常有趣的设计——双角色GitHub模型。每个项目配置两个独立的GitHub机器人账户：

• 实现者账户：负责编写代码和创建PR
• 审查者账户：负责审查代码和批准合并

为什么要这样做？这是为了防止AI代理陷入自我反馈循环。如果使用同一个账户既写代码又审查代码，理论上AI可能会不断自我修正而无法收敛。通过物理隔离这两个角色，Cascade确保了代码审查的独立性和客观性。

Cascade的技术架构由三个独立服务组成：

服务	入口文件	职责
Router	src/router/index.ts	接收Webhook，通过BullMQ将任务入队到Redis
Worker	src/worker-entry.ts	每个容器处理一个任务，完成后退出
Dashboard	src/dashboard.ts	提供tRPC API和Web界面

这种微服务架构使得系统具有良好的可扩展性和容错性。Worker服务的"一个容器一个任务"设计特别值得注意——它确保了资源隔离，即使某个任务失败也不会影响其他任务。

Cascade在安全性方面也做了充分考虑：

• 凭证加密：所有存储的密钥使用AES-256-GCM加密
• 速率限制：内置速率限制防止API滥用
• 指数退避重试：网络故障时自动重试
• 上下文压缩：长会话时自动压缩上下文以节省token

此外，项目还提供了.cascade/目录机制，允许目标仓库自定义代理如何设置项目、编辑后如何运行lint、如何执行测试等。这种设计让Cascade能够适应不同项目的特定需求。

Cascade的安装非常简单，使用Docker Compose可以一键启动所有服务：

git clone https://github.com/mongrel-intelligence/cascade.git
cd cascade
cp .env.docker.example .env  # 按需编辑
bash setup.sh                # 构建、迁移并启动所有服务

然后访问http://localhost:3001，使用管理员凭据登录即可开始使用。