AI Agent 与人类协作的开发生命周期管理平台 (AI-DLC),基于「反转对话」理念,支持任务 DAG、MCP 协议及多 Agent 协同工作流。
Chorus 项目详解#
项目定位#
Chorus 是一个实现 AI-DLC (AI-Driven Development Lifecycle) 的协作平台,核心理念是 Reversed Conversation — AI proposes, humans verify(AI 提议,人类验证)。
通过 MCP 协议协调 PM、Developer、Admin 三类 Agent 与人类用户进行结构化的任务共创与验证,解决传统软件开发中 AI 角色边界不清、协作效率低、可追溯性差的问题。
核心架构#
三种 Agent 角色#
| 角色 | 职责 | MCP 工具前缀 |
|---|---|---|
| PM Agent | 分析 Idea、创建 Proposal (PRD + 任务分解)、管理文档 | chorus_pm_* |
| Developer Agent | 认领任务、编写代码、汇报工作、提交验证 | chorus_*_task, chorus_report_work |
| Admin Agent | 创建项目/Idea、审批 Proposal、验证任务、管理生命周期 | chorus_admin_* |
AI-DLC 工作流#
Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Verify ──> Done
^ ^ ^ ^ ^ ^
Human PM Agent PM Agent Dev Agent Admin Admin
关键特性#
- Kanban & Task DAG: 任务支持依赖关系 (DAG),Kanban 实时显示任务状态和活跃 Worker
- Session Observability: 每个 Developer Agent 创建独立 Session,UI 实时显示 Agent 工作状态
- Multi-Agent Collaboration (Swarm Mode): 支持 Claude Code Agent Teams 并行多 Agent 执行
- Chorus Plugin for Claude Code: 自动化 Session 生命周期管理
- Requirements Elaboration: PM Agent 通过结构化 Q&A 轮次在创建 Proposal 前澄清需求
- Notification System: 应用内通知 + SSE 实时推送 + Redis Pub/Sub 跨实例传播
- Activity Stream: 完整操作审计日志,支持 Agent 归因和时间戳
- 50+ MCP Tools: 覆盖 Public/Session/Developer/PM/Admin 权限域
典型应用场景#
| 场景 | 描述 |
|---|---|
| AI 原生团队协作 | 多个 AI Agent 与人类在统一平台上从需求到交付全流程协作 |
| 任务依赖管理 | 通过 Task DAG 可视化任务依赖关系,明确执行顺序和并行路径 |
| 需求澄清 | 结构化 Q&A 确保需求在规划前被充分理解 |
| Agent 活动监控 | Pixel Workspace 实时显示每个 Agent 的工作状态和终端输出 |
| 审计追踪 | 完整的操作日志,支持 Agent 归因和时间戳 |
安装部署#
Docker 快速启动#
git clone https://github.com/Chorus-AIDLC/chorus.git
cd chorus
export DEFAULT_USER=admin@example.com
export DEFAULT_PASSWORD=changeme
docker compose up -d
# 访问 http://localhost:3000
本地开发#
前置条件: Node.js 22+, pnpm 9+, Docker
cp .env.example .env
pnpm docker:db
pnpm install
pnpm db:migrate:dev
pnpm dev
Agent 连接配置#
方式一: Chorus Plugin (推荐)
export CHORUS_URL="http://localhost:3000"
export CHORUS_API_KEY="cho_your_api_key"
claude /plugin marketplace add Chorus-AIDLC/chorus
claude /plugin install chorus@chorus-plugins
方式二: 手动 MCP 配置
{
"mcpServers": {
"chorus": {
"type": "http",
"url": "http://localhost:3000/api/mcp",
"headers": { "Authorization": "Bearer cho_your_api_key" }
}
}
}
技术实现#
| 组件 | 技术 |
|---|---|
| Framework | Next.js 15 (App Router, Turbopack) |
| Language | TypeScript 5 (strict mode) |
| Frontend | React 19, Tailwind CSS 4, shadcn/ui |
| ORM | Prisma 7 |
| Database | PostgreSQL 16 |
| Cache/Pub-Sub | Redis 7 (ioredis) |
| Agent Integration | MCP SDK 1.26 (HTTP Streamable Transport) |
| Auth | OIDC + PKCE (users) / API Key cho_ prefix (agents) |
| i18n | next-intl (en, zh) |
| 开源协议 | AGPL-3.0 |