使用指南
长任务 Goal
设定一个目标,让助手自动多轮推进并独立校验是否达成,中途可暂停、替换或清除。
普通对话是「你问一句、它答一句」。长任务模式换了个玩法:你给一个目标,它自己拆解、执行、校验,一轮不达标就接着改,直到达成或者主动停下来向你汇报。
适合那种「说得清结果、但要来回折腾很多轮」的活 —— 比如「把这个模块的测试补到全绿」「按新设计稿把设置页改完」。
开始一个目标
在输入框敲:
/goal 把 src/parser 的单元测试补全,并让 pnpm test 全绿
或者按 ⌘ + G(Windows 为 Ctrl + G)。
计划模式下不能启动目标 —— 那一档不允许任何写操作。会提示你先点「开始执行」或切换权限档。
它是怎么跑的
一轮「执行 → 校验」为一个迭代:
- 执行 —— 助手按目标推进一轮。
- 校验 —— 由独立的校验环节判断目标有没有达成,不是让它自己说了算。没达成会给出原因(测试还在挂、验证缺失、活儿没干完、工具报错等)。
- 没达成就带着这个原因进入下一轮,直到达成或触发停止条件。
进度以悬浮状态卡实时展示,可以随时收起成一个小胶囊,不挡视线。
它什么时候会停下来
| 停止原因 | 说明 |
|---|---|
| 已完成 | 校验通过 |
| 已手动暂停 | 你按了暂停 |
| 连续多次执行未取得进展 | 反复报错或没干成事,卡片上会显示真实次数 |
| 校验器连续失败 | 校验环节本身出了问题 |
| 模型服务不可用 | 比如遇到无权限一类的错误,会立即停下并说明原因,不会闷头重试刷屏 |
| 已达到本窗口轮次 / 时长上限 | 预算用完了,防止无限跑下去 |
| 应用重启后已安全暂停 | 重启不会丢进度;停机时长不计入预算 |
停下来后点继续(或 /goal resume)就能接着跑。
命令一览
| 命令 | 作用 |
|---|---|
/goal <目标> | 设置目标并开始执行 |
/goal replace <目标> | 替换当前目标并重新计数(别名 edit) |
/goal pause | 暂停目标,并取消当前正在执行 / 校验的那一轮 |
/goal resume | 恢复已暂停或预算受限的目标 |
/goal clear | 清除目标,回到普通对话(别名 stop / off / reset / none / cancel) |
/goal help | 显示命令帮助(别名 ? / -h / --help) |
状态卡上也有「命令帮助」「替换目标」「清除目标」的按钮。
清除后会回到普通对话模式,当前目标的进度不再保留。替换目标则会结束当前目标并重新计数。
自动批准
长任务要连续跑很多轮,每一步都弹窗问你就失去意义了。状态卡上有 「自动批准工作区内的删除/移动」 开关,按需打开。
这个白名单在 变更前确认 档下不生效 —— 你既然选了逐个确认,就以逐个确认为准。
用之前想清楚
- 目标要可校验。「把代码写好看点」没法判定,「
pnpm lint无报错」可以。 - 权限档决定了它能自己走多远。跑长任务前先想清楚你愿意放到哪一档。
- 切走去干别的不会中断它,回来时进度还在。