orchestrix

Orchestrix - 专业化AI代理协作框架

像交响乐指挥家一样协调专业化AI代理，通过标准化工作流程完成复杂项目开发。

核心理念：设计哲学

Orchestrix 的成功在于 专业化代理的协调配合 和 标准化流程的严格执行，通过协调而非控制，实现复杂项目的高质量交付。

三大设计原则

• 协调胜过控制 (Coordination over Control): 代理通过协作达成目标，专业化分工确保每个代理发挥最大价值。
• 专业化胜过泛化 (Specialization over Generalization): 每个代理专注特定领域的深度专业能力，明确的角色界限避免职责重叠。
• 标准化胜过随意 (Standardization over Randomness): 规范化的工作流程确保可重复性，标准化的输出格式便于协作。

📚 深入了解 Orchestrix 设计哲学。

核心特性

• 🎯 专业化协作: 10个专业AI代理各司其职，协同完成从规划到开发的全过程。
• 📋 标准化流程: 严格的8步工作流程，覆盖需求、设计、开发、测试全链路，确保项目质量。
• 🌐 双环境支持: Web界面用于宏观规划与决策，IDE环境专注于编码实现，无缝衔接。
• ⚡ Claude Code自动化: 基于Task tool的智能协作模式，10倍效率提升，100%质量保障。
• 🧩 模块化扩展: 丰富的扩展包系统，可按需引入游戏开发、基础设施等专业能力。
• 🚀 项目类型支持: 同时支持从零开始的 Greenfield 开发和基于现有代码的 Brownfield 改进。

快速开始

1. 一键安装

# 通用安装
npx orchestrix install

# Claude Code 自动化安装 (推荐)
npx orchestrix install -i claude-code

此命令将自动检测并为您配置本地开发环境，支持 Cursor, Claude Code, Windsurf, Trae, Roo 等主流IDE。Claude Code用户可享受全自动化协作体验。

2. 两分钟快速体验

• 下载团队配置: 全栈开发团队
• 上传至AI平台: 在您选择的AI平台（如ChatGPT, Claude, Gemini）中上传该文件。
• 开始协作: 输入 *help 查看可用命令，然后通过 *analyst 启动项目。

📘 查看完整的 用户指南 了解更多操作细节。

标准工作流程

Orchestrix 的工作流程分为两个主要阶段，确保从宏观规划到微观实现的平稳过渡。

阶段一：需求与规划 (Web界面推荐)

graph LR
    A[Analyst<br/>项目分析] --> B[PM<br/>需求文档]
    B --> C[UX-Expert<br/>UI规范]
    C --> D[Architect<br/>技术架构]
    D --> E[PM<br/>需求对齐]
    E --> F[PO<br/>质量验证]
    F --> G[PO<br/>文档拆分]

阶段二：迭代开发 (IDE环境推荐)

graph LR
    G[PO<br/>文档拆分] --> H[SM<br/>故事创建+质量评估]
    H --> I{智能决策矩阵}
    I -->|高质量+低复杂度| J[Dev<br/>功能实现]
    I -->|需要审查| K[Architect<br/>技术审核]
    K -->|通过| J
    K -->|需修订| L[SM<br/>故事修订]
    L -->|自动批准| J
    L -->|第2轮审查| K
    J --> M[QA<br/>代码审查]
    M -->|通过| N[Done]
    M -->|需修复| J

流程细节请参考 工作流程指南。

核心代理团队

规划团队

代理角色	专业领域	核心输出
Analyst	需求分析、市场调研	project-brief.md
PM	产品管理、需求规范	prd.md
UX-Expert	用户体验设计	front-end-spec.md
Architect	技术架构设计	architecture.md
PO	质量保证、一致性验证	质量检查报告

开发团队

代理角色	专业领域	核心职责
Scrum Master	敏捷管理	用户故事创建、迭代管理
Dev	代码实现	功能开发、技术实现
QA	质量控制	代码审查、测试验证

命令参考

Web界面命令

*help          # 查看帮助信息
*analyst       # 切换到需求分析师
*pm            # 切换到产品经理
*architect     # 切换到架构师
*kb-mode       # 启用知识库模式

IDE核心命令

SM (Scrum Master):

• *draft - 创建新故事
• *revise - 根据反馈修订故事
• *story-checklist - 执行质量验证

Architect:

• *review-story {story_id} - 技术审核故事
• *create-doc {template} - 创建架构文档

Dev (Developer):

• *develop-story {story_id} - 实现故事功能
• *review-qa {story_id} - 应用QA反馈修复

QA:

• *review {story_id} - 执行代码审查
• *gate {story_id} - 创建质量门决策

CLI命令

npx orchestrix install    # 安装或更新框架
npx orchestrix status     # 查看安装状态
npx orchestrix list       # 列出所有可用代理

IDE代理调用

IDE	语法	示例
Cursor/Windsurf	@agent-name	@pm, @dev
Claude Code	/agent-name	/pm, /dev
Roo Code	模式选择	orchestrix-pm

文档资源

核心文档

• 📚 用户指南: 快速上手和基础操作。
• 🏗️ 核心架构: 了解技术架构和系统设计。
• 🔄 工作流程指南: 详细的8步工作流程。
• 🎯 设计哲学: 理解核心设计理念与架构原则。

Brownfield 开发指南

• ✨ Brownfield 项目增强指南: 为现有单体项目添加重大功能的完整流程（3步工作流）。
• 🔧 Brownfield 开发指南: 现有项目改进的通用指南。
• 🌐 多仓库 Brownfield 指南: 多仓库系统文档化和协调。

Greenfield 开发指南

• 🌱 多仓库 Greenfield 指南: 从零开始的多仓库项目开发流程。

高级主题

• 🧩 扩展包系统: 探索模块化扩展机制。
• 🚀 版本发布指南: 自动化版本管理与发布流程。
• 📊 决策评估器指南: 智能决策系统使用指南。
• 📖 Story 状态参考: Story 生命周期和状态管理。

许可证

MIT License - 详见 LICENSE

_{🎼 为专业AI代理协作而设计 | ❤️ 服务全球开发者社区}