08. 扩展 Matcha
目标、工作流与深度研究
这些命令在这台机器上协调长时间工作:一个自主目标、一份已保存的 Rhai 工作流,或内置的深度研究运行。它们受 **会话门槛** 控制。若对应工具未注册,斜杠条目会隐藏 — 把该命令视为本次会话不可用。
它们何时出现
| 命令 | 本会话门槛 |
|---|---|
/goal | 目标模式已开 **且** 目标工具已注册(update_goal,或工作流引擎主机驱动) |
/workflow、/deep-research | workflow 工具已注册 |
/workflow pause|resume|stop|save | 同上,**或** 本次会话已有工作流运行 |
/workflows | 分页器命令;**仅全屏**(不是 /minimal) |
配置默认解析为 **开**,除非杀开关(GROK_GOAL=0、GROK_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-changes、review-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 |