名称: maestro 描述: 基于面试驱动规划和团队执行的 AI 代理工作流。使用 /design 开始规划，/work 执行。
Maestro 工作流
“一次性花费令牌制定好计划；多次重复使用。”
触发器
| 触发器 | 动作 |
|---|---|
/design <请求> |
启动 Prometheus 面试模式（支持 --quick） |
/work |
使用代理团队执行计划（支持 --resume） |
/setup-check |
验证 Maestro 先决条件 |
/status |
显示当前 Maestro 状态 |
/review |
执行后计划验证 |
/styleguide |
将代码风格指南注入项目 CLAUDE.md |
/setup |
搭建项目上下文（产品、技术栈、指南） |
/reset |
清理过时的 Maestro 状态 |
/analyze <问题或主题> |
深度只读调查，带结构化报告 |
/note [--priority <P0-P3>] <文本> |
捕获决策、上下文和约束到持久记事本 |
/learner [--from-session | --from-diff | <主题>] |
提取硬性原则作为可重学习技能 |
/security-review [<文件> | --diff [范围]] |
委托安全分析，带严重性评级 |
/ultraqa [--tests|--build|--lint|--typecheck|--custom '<命令>'] |
迭代修复和验证循环（最多5轮） |
/research <主题> [--depth shallow|deep] |
多代理研究，带会话持久化 |
/trace |
显示代理执行时间线和性能摘要 |
/doctor |
诊断和修复 Maestro 安装问题 |
/psm |
项目会话管理器 — 使用 git worktrees 和 tmux 的隔离开发环境 |
/release |
自动化发布工作流，包括版本升级、标签、发布和 GitHub 发布 |
@tdd |
TDD 实现（kraken） |
@spark |
快速修复 |
@oracle |
战略顾问（sonnet） |
@explore |
代码库搜索 |
规划流程
/design → prometheus（团队领导） → 检测库 → 获取文档（Context7/WebSearch） → 生成 explore/oracle → 面试 → leviathan（评审） → 计划文件
- 用户触发
/design <描述> - Prometheus 如需研究则创建团队
2.5. 从
.maestro/wisdom/加载先前智慧（如果有） 2.7. 检测外部库/框架提及并通过 Context7 MCP 获取文档（回退到 WebSearch/WebFetch） - 生成 explore 进行代码库研究（和相关时进行网络研究）
- 生成 oracle 进行架构决策
- 进行结构化面试（一次一个问题，多选选项，增量验证）
- 在
.maestro/drafts/{主题}.md中起草更新 - 清晰时，生成计划到
.maestro/plans/{名称}.md - 生成 leviathan 验证计划质量
- 清理团队
快速模式（--quick）简化为：团队 → 1 explore → 1-2 个问题 → 计划
执行流程
/work → orchestrator（团队领导） → 并行生成工作器 → 工作器自认领任务
- 用户触发
/work - Orchestrator 从
.maestro/plans/加载计划 2.5. 验证计划结构并在继续前与用户确认 2.7. 可选创建 git worktree 用于隔离执行（防止并发会话冲突） - 通过 TaskCreate 创建带依赖的任务
- 并行生成 2-4 个工作器（kraken, spark）
- 分配第一轮，工作器通过 TaskList 自认领剩余
- Orchestrator 验证结果，提取智慧到
.maestro/wisdom/ - 建议
/review进行执行后验证
使用 --resume 跳过已完成任务。
状态目录
.maestro/
├── plans/ # 已提交的工作计划
├── drafts/ # 面试草案
├── wisdom/ # 积累的学习
└── context/ # 项目上下文（产品、技术栈、指南）
.worktrees/ # 用于隔离计划执行的 Git worktrees（项目根目录）
代理
| 代理 | 目的 | 模型 | 团队领导？ | 有团队工具？ |
|---|---|---|---|---|
prometheus |
面试驱动规划器。检测库并通过 Context7 MCP 获取文档。有网络研究工具（WebSearch, WebFetch）。 | sonnet | 是 | 是（完整） |
orchestrator |
执行协调器 | sonnet | 是 | 是（完整） |
kraken |
TDD 实现 | sonnet | 否 | 是（自认领） |
spark |
快速修复 | sonnet | 否 | 是（自认领） |
oracle |
战略顾问 | sonnet | 否 | 是（自认领） |
explore |
代码库搜索 | haiku | 否 | 是（自认领） |
leviathan |
深度计划评审器 | sonnet | 否 | 是（自认领） |
wisdom-synthesizer |
知识整合 | haiku | 否 | 是（自认领） |
progress-reporter |
状态跟踪 | haiku | 否 | 是（自认领） |
security-reviewer |
安全分析（只读） | sonnet | 否 | 是（自认领） |
所有代理都有 TaskList、TaskGet、TaskUpdate、SendMessage 用于团队自协调。只有团队领导有 Task、TeamCreate 和 TeamDelete 用于生成。
代理团队设置
需要在 ~/.claude/settings.json 中设置实验性功能标志：
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
技能互操作性
Maestro 自动检测已安装技能并将其指导注入工作器提示。这允许工作器遵循项目特定约定而无需手动配置。
发现位置：
- 项目：
.claude/skills/ - 全局：
~/.claude/skills/
优雅降级： 如果未找到技能，工作流正常进行无注入。
详见 docs/SKILL-INTEROP.md 完整详情。
快速参考
- 设计：
/design add user authentication - 执行：
/work - 研究：
@explore、@oracle、/research - 实现：
@tdd、@spark - 分析：
/analyze、/security-review、/trace - 质量：
/ultraqa、/review、/doctor - 知识：
/note、/learner - 设置：
/setup、/psm、/release