企业官网建设流程全解析

理解Maestro的规格驱动开发：PLAN-SPECIFY-EXECUTE-REFINE四步法完整指南

【免费下载链接】MaestroAgent Orchestration Command Center项目地址: https://gitcode.com/GitHub_Trending/maestro41/Maestro

Maestro 是一个 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 中：

💡为什么有效？每个任务都在隔离的全新会话中运行，没有上下文串扰；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.md
• OpenSpec：/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 会：

1. 📋 按顺序处理文档中的任务清单
2. 🚀每个任务都启动一个全新会话——干净上下文，无串扰
3. ✅ 完成后自动勾选对应的任务复选框

这是 EXECUTE 阶段最妙的设计：执行被拆成一个个隔离的小会话。单个任务失败不会把整个上下文搞乱，重跑也只需从失败的那个任务继续。你还可以用 Playbook 把多份规格文档的排序和选项保存下来，形成可重复的工作流；用 Git Worktree 让多个 Agent 在不同分支上并行执行不同规格。

第四步：REFINE 改进——看一眼结果，让规格持续进化

执行完成后，打开History（历史）面板查看每个任务的执行结果与摘要：

REFINE 阶段就是回到起点再循环一次：

• 发现实现不符合预期？→ 回到AI Terminal和 AI 讨论，更新规格文档中的任务描述
• 规格有新遗漏？→ 再补一条任务，让 Auto Run 重新执行
• 一切顺利？→ 把这份"进化后"的规格存档，作为下一次迭代的基础

官方文档总结得非常好："Review, adjust specs, re-run - specs evolve with your understanding"（评审、调整规格、重跑——规格随你的理解一起演进）。四步法本质上是一个螺旋上升的闭环，而不是一次性的直线流程。

四步法速查清单 📌

新手最佳实践

1. 一次只做一个功能——一份规格文档聚焦一个逻辑变更，任务控制在可管理规模
2. 先提案后执行——没有评审过的规格不要直接 Run，尤其是用 OpenSpec 时
3. 多次澄清——Spec-Kit 的/speckit.clarify可以反复跑，每轮都会挖出新的模糊点
4. 善用并行——借助 Worktree 子代理，让多份规格在不同分支上同时自动执行
5. 及时归档——完成的变更归档后，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