08. 扩展 Matcha

目标、工作流与深度研究

这些命令在这台机器上协调长时间工作:一个自主目标、一份已保存的 Rhai 工作流,或内置的深度研究运行。它们受 **会话门槛** 控制。若对应工具未注册,斜杠条目会隐藏 — 把该命令视为本次会话不可用。

它们何时出现

命令本会话门槛
/goal目标模式已开 **且** 目标工具已注册(update_goal,或工作流引擎主机驱动)
/workflow/deep-researchworkflow 工具已注册
/workflow pause|resume|stop|save同上,**或** 本次会话已有工作流运行
/workflows分页器命令;**仅全屏**(不是 /minimal

配置默认解析为 **开**,除非杀开关(GROK_GOAL=0GROK_WORKFLOWS=0,或远程 false)把它们关掉。这些名字是兼容用的环境变量,不是 Grok 产品路径。

`/goal` — 一个目标,多轮推进

若斜杠菜单里有 /goal

/goal Migrate the auth module to the new API
/goal Migrate the auth module --budget 200000
/goal status
/goal pause
/goal resume
/goal clear

参数是 <objective> [--budget <tokens>],或 status / pause / resume / clear--budget 必须是末尾独立标志,后接正整数。该预算是目标运行的 **token**,不是工作流用的助手计次预算。

Matcha CLI 会保持目标活跃,直到独立的证据复核能复现该主张。若复核不能,目标保持活跃,或带着缺口暂停。不带文字的 /goal(或 status)报告当前目标。

由哪个驱动来跑,取决于后台工作流:开着时,主机评估轮次并核验完成候选;关着时,面向模型的 update_goal 路径报告进度。

/ 隐藏了 goal,则本次会话 /goal 不可用。

`/workflow` — 启动或管理一次命名运行

workflow 工具已注册,已保存的脚本在:

  • 项目:<repo>/.matcha/workflows/*.rhai(仍会扫描旧的 .grok/workflows/
  • 用户:~/.matcha/workflows/*.rhai

文件名主干必须匹配 meta.name。项目工作流遵循文件夹信任(与钩子同一存储)。

/workflow review-changes {"target":"origin/main...HEAD"}
/workflow pause review-changes
/workflow resume review-changes
/workflow stop review-changes-2
/workflow save review-changes

同一份定义启动两次,显示名会编号(review-changesreview-changes-2)。用那个名字,不要用内部运行 ID。

同一进程内的暂停/恢复,会从已提交的主机调用结果继续原始脚本、参数和 agent_budget。**受预算限制** 的运行不能用 /workflow resume <name> 裸恢复 — 必须通过模型/工具恢复来提高上限。进程重启打断的运行不会恢复。恢复不是恰好一次:结果未提交的副作用可能再跑一遍。

/workflow save 写入一份项目副本。已知内置项和带编号的重复句柄禁用保存 — 另选一个唯一的 meta.name

`/workflows` — 运行看板

/workflows

仅全屏。这是 **正在运行** 的列表(阶段、助手、进度),不是 .rhai 文件目录。在某次运行的详情里:p 暂停,r 恢复(普通暂停),x 停止,s 保存(允许时)。

若你在 /minimal,Matcha CLI 会让你先 /fullscreen

`/deep-research` — 有界的研究工作流

若菜单里有 /deep-research

/deep-research Compare the migration risks of PostgreSQL 17 and MySQL 9

这会启动 **内置** deep-research 工作流。命令立即返回。看 /workflows;报告落到对话里。通过独立核验器的主张会引用;失败分片和丢弃的主张把报告标为 **Partial**。

具名斜杠启动使用默认助手预算(128 次逻辑子调用,主机并发上限通常 32)。这不是 /goal --budget

若菜单里没有 /deep-research,则本次会话未注册 workflow 工具 — 该命令不可用。

你应该看到

你运行了结果
/ 显示 goal目标工具可用;/goal … 是可用步骤
/ 隐藏 goal本次会话不可用
/workflow <name> …后台运行;在 /workflows 里跟进 — 未过门槛则隐藏
/deep-research <query>内置研究运行,或未过门槛则隐藏
在 minimal 里执行 /workflows报错,指向 /fullscreen