Chorus：AI 与人类协作的代理基础设施 (Agent Harness)

Chorus 是一个代理基础设施（Agent Harness），它围绕 LLM 代理（Agent）构建，用于管理会话生命周期、任务状态、子代理编排、可观测性和故障恢复。它支持多个 AI 代理（具有细粒度、可配置的权限）与人类协作，共同完成从需求到交付的全流程工作。

该项目灵感来源于 AI-DLC (AI-Driven Development Lifecycle，AI 驱动开发生命周期) 方法论。其核心理念为：反向对话（Reversed Conversation） — 即由 AI 提出方案，人类进行验证。

---

AI-DLC 工作流

Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Verify ──> Done
  ^          ^               ^                     ^          ^         ^
Human     idea:write     proposal:write         task:write   *:admin    *:admin
creates   + elaborate    + drafts                + reports   + verifies + closes

每个阶段下方的标签是参与者在该阶段所需的权限——这些权限可以授予人类、代理（预设或自定义）或两者。这里没有固定的角色；5 × 3 的权限矩阵支持任何组合方式。详情请参阅 docs/PERMISSIONS.md。

---

更新日志

v0.9.0 — 引入“头脑风暴（Brainstorm）”技能，用于处理模糊构思（在结构化问答前的开放式对话），以及构思完成报告（每个已交付的构思都会生成总结/决策/后续行动报告，并展示在构思概览中）。

v0.8.0 — 支持 OpenSpec 感知模式（Claude Code）：当检测到 openspec/ 目录且 openspec CLI 存在时自动激活，添加 /opsx/{explore,propose,apply,archive} 指令以及验证后的归档触发钩子。

v0.7.0 — 细粒度代理权限：引入 5 资源 × 3 操作的权限网格，取代原有的 PM/开发者/管理员三选一模式，支持预设项 + 自定义选项，可自由组合。

v0.6.7 — Codex CLI 的 Chorus 插件（一键安装）、当一个邮箱关联多个公司时的企业选择器，以及针对不同客户的连接指南。

v0.6.6 — npm 一键安装 (npx @chorus-aidlc/chorus)、文档导出（MD/PDF/Word）、撤销方案，以及通过工作状态预览实现更快速的代理签到。

v0.6.2 — 内置 PGlite 模式（零依赖部署）、使用 Pino 进行结构化日志记录、用于水平扩展的无状态 MCP，默认端口更改为 8637。

v0.6.1 — /yolo 技能：全自动 AI-DLC 流水线（构思 → 方案 → 执行 → 验证），支持代理团队并行执行。

v0.6.0 — IdeaTracker 看板、独立的审查代理（方案审查员 + 任务审查员）、实时代理在线状态指示器、跨列看板动画。

完整变更日志：CHANGELOG.md

---

快速开始

通过两条命令即可在本地运行 Chorus——无需数据库、无需 Docker、无需配置文件。

npm install -g @chorus-aidlc/chorus
chorus

安装完成后，Chorus 会启动内置的 PostgreSQL (PGlite)，自动执行数据库迁移，并在 http://localhost:8637 打开。

注意： PGlite 是一个嵌入式单进程 PostgreSQL，非常适合本地单用户使用，但在高并发负载下其连接处理有限。如果您计划同时运行多个代理或供多用户使用，请通过 DATABASE_URL=postgresql://... 使用外部 PostgreSQL，或使用完整的 Docker Compose 堆栈。

默认登录信息：admin@chorus.local / chorus

选项

# 自定义端口
chorus --port 3000

# 自定义数据目录 (默认: ~/.chorus-data)
chorus --data-dir /path/to/data

# 自定义登录凭据
DEFAULT_USER=me@example.com DEFAULT_PASSWORD=secret chorus

# 使用外部 PostgreSQL 而不是内置的 PGlite
DATABASE_URL=postgresql://user:pass@host:5432/chorus chorus

其他部署方式

方法	命令
npm (最简单)	npm i -g @chorus-aidlc/chorus && chorus
Docker (独立版)	docker compose -f docker-compose.local.yml up
Docker (完整栈)	docker compose up (PostgreSQL + Redis + Chorus)
AWS CDK	部署到 AWS

---

屏幕截图

方案生成 — AI 代理实时生成计划

观察 PM 代理分析需求并生成包含 PRD 和任务 DAG 的方案——实时状态指示器显示了代理的活动情况。

Pixel 工作区 — 实时代理状态