orch-agents：自主开发代理编排系统

orch-agents 是一个受 OpenAI Symphony 启发的开发工作流编排系统，通过 GitHub Webhook 和 Linear 集成，自动调度多智能体团队完成代码审查、Bug 修复、功能开发、CI 失败修复等重复性任务，旨在减少工程师在这些任务上的时间投入，让他们专注于更具创造性的工作。

在软件开发中，代码审查、Bug修复、CI失败调试等重复性任务占据工程师大量时间。orch-agents 项目受 OpenAI Symphony 和 Linear Agent Interaction Guidelines 启发，试图通过智能体编排（Agent Orchestration）自动化这些工作流，构建可扩展的系统监听代码仓库和项目管理工具事件，调度合适的AI智能体团队完成任务。

事件驱动架构

系统采用事件驱动设计，流程为：Webhook到达→签名验证→输入清洗→事件标准化→查找WORKFLOW.md→匹配模板→创建智能体工作区→顺序执行→质量审查→提交结果→清理工作区。支持GitHub和Linear事件源，统一映射为内部IntakeEvent格式。

智能体团队模板

WORKFLOW.md是核心配置文件，定义智能体团队模板（如tdd-workflow对应coder+tester）和事件路由规则（如GitHub PR打开触发github-ops，Issue打bug标签触发tdd-workflow）。

隔离执行环境

每个智能体在独立Git worktree运行，确保环境隔离、安全边界和可回滚。

智能体类型

项目内置18+智能体，覆盖开发各环节：architect（系统设计）、coder（代码实现）、tester（测试编写）、reviewer（代码审查）、security-architect（安全审计）等，每个智能体通过.claude/agents/目录下的Markdown文件定义角色和规范。

质量审查机制

• 审查门：每个智能体完成工作后需通过三道审查：Claude驱动的差异审查、npm test执行、敏感信息安全扫描。
• 修复循环：审查失败时自动进入修复循环（生成建议→智能体修复→重新审查），最多尝试3次，失败则中止任务。

GitHub集成

• Webhook配置：Payload URL为https://your-server/webhooks/github，内容类型application/json，需配置WEBHOOK_SECRET，监听Push、PR、Issues等事件。
• 认证模式：推荐GitHub App（操作显示为orch-agents[bot]，防反馈循环），也支持个人访问令牌（适合开发测试）。

Linear集成

通过配置文件连接Linear，当卡片移动到活跃状态（unstarted/started）时触发相应工作流。

使用场景

• 自动化代码审查：PR提交后reviewer智能体自动审查并发布评论。
• 智能Bug修复：Issue打bug标签后，coder+tester团队自动分析根因、编写修复和测试、提交PR。
• CI失败修复：main分支CI失败时，quick-fix智能体自动定位问题并推送修复。
• 功能开发流水线：Issue打feature标签后，architect→coder→reviewer依次完成设计到审查。

技术栈

运行时Node.js22+，语言TypeScript，AI引擎Claude Code，测试含730+用例，支持Docker、Cloudflare Tunnel部署。

成本考量

智能体调用消耗Claude API token，大型项目或高频事件可能产生可观费用。

审查准确性

AI生成代码仍可能存在逻辑错误或边界处理不当，关键代码需人工最终审查。

配置复杂度

WORKFLOW.md的路由规则和条件判断有一定学习曲线。

orch-agents展示了AI智能体在软件开发工作流中的巨大潜力，通过合理编排和质量控制，显著减少工程师重复性任务时间。对于探索AI驱动开发流程的团队，这是值得研究和尝试的项目，其模块化设计和清晰架构也为构建复杂智能体系统提供良好参考。建议有兴趣的团队深入了解并实践该系统。