理解Maestro的规格驱动开发PLAN-SPECIFY-EXECUTE-REFINE四步法完整指南【免费下载链接】MaestroAgent Orchestration Command Center项目地址: https://gitcode.com/GitHub_Trending/maestro41/MaestroMaestro 是一个 Agent 编排指挥中心Agent Orchestration Command Center它用规格驱动开发Spec-Driven Development重新定义了 AI 辅助编程的工作流。在这篇文章里我们将用最易懂的方式拆解 Maestro 的PLAN-SPECIFY-EXECUTE-REFINE 四步法先规划、再写规格、自动执行、最后迭代改进。无需深厚背景跟着走完一遍你就能明白为什么这种先写规格、再跑代码的方式比随口提示 AI 更可靠。为什么需要规格驱动开发传统的 AI 编程方式是想到什么问什么——俗称 ad-hoc prompting即兴提示。这带来三个典型痛点缺乏思考需求没想清楚就动手AI 只能按模糊意图猜测没有文档做完的东西没有任何可追溯的记录上下文污染一个超长会话里任务互相干扰越聊越乱Maestro 的解法是规格先行specification-first先用对话把需求想透再落成一份带任务清单的 markdown 规格文档最后交给 Auto Run 逐任务自动执行。官方文档对四步法的定义就写在 docs/about/overview.md 中步骤做什么产出1. PLAN与 AI 讨论功能需求清晰的需求共识2. SPECIFY生成带任务清单的 markdown 文档规格文档存入 Auto Run 文档文件夹3. EXECUTEAuto Run 逐任务执行每个任务开新会话已完成的代码与勾选记录4. REFINE查看结果、更新规格、再次执行不断演进的规格与代码为什么有效每个任务都在隔离的全新会话中运行没有上下文串扰markdown 规格文档本身就是活文档随你的理解一起进化。第一步PLAN 规划——和 AI 把需求聊透在 Maestro 的AI Terminal中把功能想法直接说给 AI。例如我想给项目添加用户认证支持 OAuth 登录。不要急着让它写代码。让 AI 反问你支持哪些 OAuth 提供方错误怎么处理要不要兼容已有的登录逻辑这一轮对话的价值在于强制你在编码前想清楚需求边界——这正是 PLAN 阶段的核心。Maestro 的 AI Terminal 支持多标签页并行对话每个标签页即一个会话、文件引用和斜杠命令完整交互方式见 docs/general-usage.md。第二步SPECIFY 规格化——把共识变成可执行的文档需求聊清楚后让 AI 把共识固化为规格文档。典型指令请为这个功能创建一份 markdown 实施清单。然后把这份文档保存到项目的Auto Run 文档文件夹项目/.maestro/playbooks/或者干脆让 AI 直接写入。这份文档就是后续自动执行的剧本。Maestro 内置了 Onboarding Wizard 引导式流程会用对话式向导帮你从零生成第一份规格文档进阶用内置的 Spec-Kit 与 OpenSpec 命令如果你想要更结构化的规格流程Maestro 内置了两套来自社区的规格驱动开发工具在Settings → AI Commands中查看和管理提示词会自动保持更新Spec-Kit/speckit.constitution定项目原则→/speckit.specify写功能规格→/speckit.clarify补漏洞→/speckit.plan实施计划→/speckit.tasks任务拆解详见 docs/speckit-commands.mdOpenSpec/openspec.proposal变更提案→/openspec.apply实施→/openspec.archive归档适合对已有功能做迭代式修改详见 docs/openspec-commands.md两套工具都能通过/speckit.implement和/openspec.implement命令把任务清单自动转成 Auto Run 文档与 Maestro 的多智能体执行能力打通。内置的规格提示词模板可以在 src/prompts/ 目录中找到例如autorun-default.md和openspec/子目录。第三步EXECUTE 执行——Auto Run 逐任务自动开工规格文档就绪后切换到Auto Run标签页选中文档点击 Run。Maestro 会 按顺序处理文档中的任务清单每个任务都启动一个全新会话——干净上下文无串扰✅ 完成后自动勾选对应的任务复选框这是 EXECUTE 阶段最妙的设计执行被拆成一个个隔离的小会话。单个任务失败不会把整个上下文搞乱重跑也只需从失败的那个任务继续。你还可以用 Playbook 把多份规格文档的排序和选项保存下来形成可重复的工作流用 Git Worktree 让多个 Agent 在不同分支上并行执行不同规格。第四步REFINE 改进——看一眼结果让规格持续进化执行完成后打开History历史面板查看每个任务的执行结果与摘要REFINE 阶段就是回到起点再循环一次发现实现不符合预期→ 回到AI Terminal和 AI 讨论更新规格文档中的任务描述规格有新遗漏→ 再补一条任务让 Auto Run 重新执行一切顺利→ 把这份进化后的规格存档作为下一次迭代的基础官方文档总结得非常好Review, adjust specs, re-run - specs evolve with your understanding评审、调整规格、重跑——规格随你的理解一起演进。四步法本质上是一个螺旋上升的闭环而不是一次性的直线流程。四步法速查清单 阶段在哪里操作关键动作常见信号PLANAI Terminal与 AI 讨论需求明确边界能一句话说清做什么、不做什么SPECIFYAI Terminal / Wizard生成带清单的 markdown 规格文档已存入.maestro/playbooks/EXECUTEAuto Run 标签页选中文档点 Run任务复选框逐个被勾选REFINEHistory 面板查看结果、修订规格、重跑规格文档版本号/内容持续演进新手最佳实践一次只做一个功能——一份规格文档聚焦一个逻辑变更任务控制在可管理规模先提案后执行——没有评审过的规格不要直接 Run尤其是用 OpenSpec 时多次澄清——Spec-Kit 的/speckit.clarify可以反复跑每轮都会挖出新的模糊点善用并行——借助 Worktree 子代理让多份规格在不同分支上同时自动执行及时归档——完成的变更归档后changes/目录保持干净追溯更容易总结Maestro 的规格驱动开发把AI 编程从一场即兴对话变成了一条可重复的工程流水线PLAN 让需求想清楚SPECIFY 让共识落成文档EXECUTE 让 Auto Run 隔离地干活REFINE 让整个系统螺旋上升。对于刚接触多智能体编排的新手建议从最简路径起步——AI Terminal 聊需求 → 让 AI 写清单 → Auto Run 执行 → History 回顾跑通一轮完整循环后再按需引入 Spec-Kit 或 OpenSpec 的结构化命令。更多规格与提示词的细节可以参考 docs/agent-guides/PROMPTS-SPECS.md 深入源码层面的设计。【免费下载链接】MaestroAgent Orchestration Command Center项目地址: https://gitcode.com/GitHub_Trending/maestro41/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
