Maestro Auto Run 文档写作指南10个让任务清单真正跑起来的技巧【免费下载链接】MaestroAgent Orchestration Command Center项目地址: https://gitcode.com/GitHub_Trending/maestro41/MaestroMaestro是一款 AI 智能体编排指挥中心Agent Orchestration Command Center它的Auto Run功能可以读取你写好的 Markdown 任务清单把每一个未勾选的复选框交给一个全新的 AI 会话去自动完成。本文是面向新手的 Maestro Auto Run 文档写作指南用 10 个实用技巧告诉你如何把一份普通任务清单变成可以无人值守、稳定跑完的自动化流水线。1. 找到 Auto Run 面板并选择任务文件夹打开 Maestro 右侧面板的Auto Run标签快捷键CmdShift1/CtrlShift1选一个存放 Markdown 文档的文件夹每个.md文件都会变成一个可执行文档。运行清单的快捷键是CmdShift2/CtrlShift2。 记住这两个快捷键之后所有技巧都在这个面板里操作。2. 用复选框写任务一个任务一行写清背景Auto Run 的执行单位是 Markdown 复选框任务- [ ] 实现用户登录接口 - [ ] 为登录流程补充单元测试 - [ ] 更新 API 文档写作要点每个任务一行动词开头验收标准可检查在文档开头用几段话写清楚背景、关键文件路径、约束条件Agent 每次都会重新读文档这些上下文会跟着任务一起送达写作时按CmdL/CtrlL可以快速插入新复选框。3. 合理选择任务粒度多任务 vs 一文档一任务官方推荐两种结构可以混用粒度适合场景注意点一个文档放多个任务任务小而独立共享背景很简短每个任务要能自包含一个文档只放 1~几个任务推荐任务需要大量背景、引用、约束用 Playbook 串联多个文档经验法则如果你发现同一段背景要在多个复选框上方反复出现就该拆成多个专注文档让 Playbook 负责排序。4. 理解 Fresh Context按任务隔离还是按文档连续运行配置弹窗中的Fresh context per开关决定上下文范围Task默认推荐每个未勾选任务都启动一个全新 Agent上下文零污染行为可预测Document一个 Agent 连续做完整个文档适合上下文窗口很大、后续任务依赖前面成果的工作。Maestro 会根据 Agent 的上下文窗口大小自动给出推荐。无论哪种模式任务本身都应写得自包含——不要依赖Agent 记得刚才的对话。5. 多文档排队 Loop 模式一次跑完整个项目点击Run打开配置弹窗后用 Add Docs把多个文档加入队列拖拽调整顺序。每个文档可以单独设置Reset on Completion不修改原文件而是在runs/子文件夹生成工作副本如TASK-xxx-loop-1.md原文件永远不动副本就是审计日志Duplicate同一文档重复入队Loop Mode跑完最后一个文档后自动回到第一个适合需要反复迭代的流水线。另外在Files标签中右键 Auto Run 文件夹里的任意文件选择Stage Documents for Auto Run可以一键把整个文件夹的任务批量加入队列。6. 把配置保存为 Playbook一键复用配置好的文档、顺序和选项点Save as Playbook命名保存之后从Load Playbook下拉框一键加载。这意味着一次精心设计的写作就能在多个项目里反复运行——这正是文档写作指南的核心价值好的 Playbook 是资产不是草稿。7. 用 Inline Wizard 让 AI 帮你写任务文档不想从零写在任意 AI 标签输入/wizard或点 Auto Run 面板的 Wizard 按钮和 AI 聊你的项目目标屏幕下方的项目理解置信度条会随对话上升达到 80% 以上时AI 会自动生成详细的 Auto Run 任务文档存放在 Auto Run 文件夹的独立子文件夹中。生成后直接点 Run 就能开跑也可以先人工审一遍任务措辞再执行。8. 用模型标记给任务分档省钱又不降智大部分 Playbook 是前期侦察便宜、后期设计昂贵的。在文档中写入一行标记即可切换任务使用的模型档位与努力程度!-- MAESTRO:MODEL tierlow effortlow -- - [ ] 梳理现有中间件的所有调用点 - [ ] 设计迁移方案 !-- MAESTRO:MODEL tierhigh efforthigh --规则很简单标记单独占一行作用于它下面的所有任务直到下一个标记标记写在任务行末尾只作用于这一个任务low/medium/high是相对档位Maestro 会自动映射到各提供商的对应模型。典型用法是整篇low 一两个high关键任务总花费往往比全程高档更省。标记还支持reason...属性解释为什么这么选方便以后回看时判断当初的决定是否合理。9. 需要人把关时用 HITL 门暂停执行当某个任务必须由人类完成人工测试、凭据录入、最终签字在它上方写一行门控标记例如!-- MAESTRO:HITL reason运行邮件任务前请先在 .env 中添加 SENDGRID_API_KEY -- - [ ] 发送测试邮件执行到这里时Auto Run 会显式暂停在面板和通知中展示原因你勾掉标记上方的复选框或点 Resume 即可继续。面板会给所有标记渲染小药丸提示如在此暂停让你一眼看到哪里会停下来——这是刻意的暂停而不是卡死。10. 在 Worktree 中运行长任务主分支永远安全较长的 Auto Run 建议在独立 git worktree 中运行在配置弹窗打开Dispatch to a separate worktree选择新建或已有 worktree、指定基础分支如main勾选Automatically create PR后整个运行都在隔离分支上进行跑完自动开出 Pull Request 等待审查你的主工作区始终干净。附新手避坑速查表情况Maestro 会怎么做你需要做什么提供商过载 / 额度用尽Agent Resilience 自动退避重试夜间批量任务不会静默卡死通常无需操作可观察状态卡片同一文档连续 3 次没有推进判定卡死跳过该文档继续下一个查看 History 中记录的原因修改任务措辞Agent 发现后续任务已无意义写入 halt 标记整体中止删除残留的 halt 标记后才能重新运行任务需要环境变量继承被运行 Agent的配置文档本身不能设置在 配置 的 Agent 环境变量中设置想中途停下点 Stop当前任务完成后停止再点 Run 即可从断点恢复参考资料完整功能说明Auto Run Playbooks社区模板市场Playbook Exchange可在 Auto Run 面板点 Exchange 按钮打开导入现成的安全审计、代码评审等 Playbook容错机制Agent ResilienceCLI 运行方式CLI 参考模型档位解析实现src/shared/autorunModelHints.ts任务提示词模板src/prompts/含autorun-default.md、autorun-per-task.md等最后提醒写 Auto Run 文档的本质是把你希望 Agent 怎么干活沉淀成可重复执行的资产。先跑通一个 3 行的小清单再逐步叠加 Playbook、Loop、模型分档和 Worktree你就能体会到把整晚任务托付给 Agent 的安心感。【免费下载链接】MaestroAgent Orchestration Command Center项目地址: https://gitcode.com/GitHub_Trending/maestro41/Maestro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
