Package Exports

orchestrix
orchestrix/tools/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (orchestrix) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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代理协作而设计 | ❤️ 服务全球开发者社区}