Maestro
18 阶段产研全流程 AI 指挥家 — 从需求调研到部署上线，37 个 Skill + 24 个 Agent + 11 个 Hook 协同编排。
概览
Maestro 是一个 Claude Code 插件，将完整的产研工作流（需求调研 → 部署上线）自动化。纯 Markdown Skills + Agent 定义，零运行时依赖。
核心隐喻：Maestro（指挥家）— 编排 18 阶段产研工作流，调度 24 个 Agent，协调 37 个 Skill，管理 11 个 Hook，如同指挥家统领整个交响乐团。
安装
前提
方式一：官方插件命令安装（推荐）
# 1. 添加市场源（只需一次）
/plugin marketplace add lyuxiaohei/Maestro
# 2. 安装插件
/plugin install maestro@maestro-marketplace
更新插件：
# 1. 刷新市场缓存（获取最新版本）
/plugin marketplace update maestro-marketplace
# 2. 更新插件
/plugin update maestro
卸载：
/plugin uninstall maestro
方式二：install.js 安装（降级方案）
一行命令安装 Maestro：
node -e "const{execSync}=require('child_process');const t=require('os').tmpdir();const p=require('path').join(t,'maestro-install');execSync('git clone https://github.com/lyuxiaohei/Maestro.git '+p,{stdio:'inherit'});execSync('node '+p+'/scripts/install.js',{stdio:'inherit'})"
或手动安装：
git clone https://github.com/lyuxiaohei/Maestro.git
cd Maestro
node scripts/install.js
项目级注册
在目标项目的 .claude/settings.json 中添加：
{
"projects": {
"/your/project": {
"plugins": ["/path/to/Maestro"]
}
}
}
首次使用
启动 Claude Code 后输入 /workflow {slug} 创建或继续工作流（slug 为工作流标识，如 user-center），自动创建多工作流状态文件：
.planning/
└── workflows/
└── {slug}/ # 每条工作流独立目录
├── workflow.md # 工作流全局状态（6 域分组阶段总览）
└── phases/
├── product/ # P01-P04 需求域
├── design/ # P05-P08 设计域
├── architecture/ # P09-P13 架构域
├── development/ # P14-P15 开发域
├── testing/ # P16-P17 测试域
└── deployment/ # P18 部署域
之后每次新会话启动时，SessionStart Hook 自动报告当前进度。
18 阶段工作流
| 阶段 | 名称 | Skill |
|---|
| P01 | 需求调研 | meeting-minutes |
| P02 | 业务现状流程图 | diagram-design |
| P03 | 会议纪要 | meeting-minutes |
| P04 | 竞品分析 | competitive-analysis |
| P05 | 功能清单 | feature-list |
| P06 | 原型设计 | prototype-design + logic-list-spec |
| P07 | 原型复核 | prototype-review |
| P08 | UI 设计 | ui-design |
| P09 | 方案设计 | logic-list-spec (Draft) |
| P10 | 架构设计 | architecture-design |
| P11 | 架构评审 | architecture-review |
| P12 | 架构细化 | architecture-refinement |
| P13 | 详细设计 | detailed-design |
| P14 | 开发任务规划 | dev-task-planner |
| P15 | 前后端开发 | frontend-dev + backend-dev + code-review |
| P16 | 系统测试 | test-engineering |
| P17 | 验收测试 | acceptance-testing |
| P18 | 部署上线 | deployment |
24 个 Agent
| Agent | 域 | 模型 | 职责 |
|---|
| phase-executor | 调度 | sonnet | 独立上下文执行阶段任务 |
| phase-validator | 调度 | sonnet | 独立验证阶段输出质量 |
| phase-planner | 调度 | sonnet | 规划阶段任务，分解目标和依赖 |
| plan-checker | 调度 | sonnet | 校验计划质量（只读） |
| research-synthesizer | 调度 | sonnet | 合并多个 researcher 输出 |
| doc-classifier | 调度 | sonnet | 文档自动分类（ADR/PRD/SPEC/DOC） |
| doc-synthesizer | 调度 | sonnet | 多文档合并、冲突检测 |
| doc-writer | 调度 | sonnet | 按模板生成/更新项目文档 |
| doc-verifier | 调度 | sonnet | 校验文档与代码库一致性 |
| lite-planner | 轻量 | sonnet | 轻量工作流规划 |
| lite-executor | 轻量 | sonnet | 轻量工作流执行 |
| lite-verifier | 轻量 | sonnet | 轻量工作流验证 |
| domain-researcher | 产品 | sonnet | 调研项目领域背景 |
| competitive-researcher | 产品 | sonnet | Web 搜索竞品信息 |
| requirement-analyst | 产品 | sonnet | 结构化需求分析 |
| product-manager | 产品/设计 | opus | 产品域+设计域规划审阅和验证（P01-P08） |
| architect | 架构 | opus | 架构域规划审阅和验证（P09-P13） |
| frontend-developer | 开发 | opus | 前端开发规划审阅和代码验证（P14-P15） |
| backend-developer | 开发 | opus | 后端开发规划审阅和代码验证（P14-P15） |
| test-engineer | 测试 | opus | 测试域规划审阅和验证（P16-P17） |
| ops-engineer | 部署 | opus | 部署域规划审阅和验证（P18） |
| security-reviewer | 安全 | sonnet | OWASP Top 10 安全审计 |
| integration-reviewer | 测试 | sonnet | 跨模块集成验证 |
| code-reviewer | 测试 | sonnet | 多角色代码审查（spec/quality/cross-task） |
5 条铁律门禁
阶段启动 → GATE-03（依赖检查）→ GATE-01（人工确认启动）
→ Skill 执行 → GATE-02（自检）→ GATE-05（Agent 验证）
→ GATE-01（人工确认输出）→ 推进下一阶段
| 门禁 | 名称 | 作用 |
|---|
| GATE-01 | 人工确认门禁 | 阶段启动/输出需用户明确确认 |
| GATE-02 | 自检门禁 | Skill 执行自检清单，不通过无法提交 |
| GATE-03 | 依赖门禁 | 上游阶段未完成时拒绝执行（用户可确认跳过） |
| GATE-04 | 中断保护门禁 | 会话中断后状态持久化，可从断点恢复 |
| GATE-05 | Agent 验证门禁 | phase-validator 独立验证输出质量 |
项目结构
