SuperAPI AI 工具集

maestro-quick

智能体与模型

查看项目

更新于 10-15 20:11

技能介绍

用途:maestro-quick 用于快速执行单个开发任务,默认跳过可选代理、保持最少交互。流程为 [discuss] → analyze-q → plan → execute → [verify]。

主要能力:解析参数并提取任务描述;加载 .workflow/state.json 与 .workflow/project.md;可选加载 coding/ui 规范与 wiki 条目;创建 .workflow/scratch/{slug}/ 并写入 config.json;可选讨论阶段对决策点做 Locked/Free/Deferred 分类;快速分析代码库并写 context.md;生成 plan.json(通常 1-5 个子任务、单波顺序执行);顺序执行任务并更新状态;可选验证阶段运行收敛标准检查;按需提交并输出报告。

用法示例:$maestro-quick "add rate limiting to /api/auth endpoints";加 --discuss 会在规划前提取决策;--full 启用计划检查(最多 2 轮)与执行后验证;--commit 在任务结束时提交,-y 自动确认并在使用 --commit 时自动提交。提交命令形如 git add <file1> <file2> ... && git commit -m "quick: {slug} - {short description}",禁止使用 git add -A。

阶段门禁:GATE 1 要求任务描述非空,否则 E001;GATE 2 要求分析完成并识别相关文件与至少一个相似实现,scratch 目录创建失败为 E002;GATE 3 要求所有计划任务已尝试并记录状态,plan.json 缺失或无任务状态则阻塞。输出边界:所有元数据写入必须指向 .workflow/scratch/{slug}/,源码修改限定在计划文件范围内,不得改动无关源文件或超出 scratch 任务条目的 .workflow/state.json 结构。

适用场景:需要低交互、快速完成小到中等代码改动(如修复内存泄漏、重构服务、添加 UI 开关)时使用。

限制:任务描述必填;依赖可用的 maestro 命令与工作区权限;--discuss、--full、--commit 等为可选行为;该项目官方说明未提供收费、价格、平台支持范围等信息,暂未提供。