SuperAPI AI 工具集

goal

智能体与模型

查看项目

更新于 10-26 18:53

技能介绍

用途:goal 为 bro 提供一个“会话级完成条件”。设定后,会话会持续工作,直到出现明确判定(已达成、不可能达成或轮次预算耗尽)才结束,适合需要跨多轮推进并最终可验证的任务。

主要能力:目标由 Stop 钩子在每轮结束后重新注入(注入目标本身或评审对该目标的结论);会话启动时会跨恢复/压缩还原目标。若配置了评审(judge.provider + goal.judge,默认开启),每次停止都会对活动目标给出类型化判定:met/impossible 会清除目标,not_met 消耗一轮预算,预算耗尽则暂停目标(可用 resume 恢复);未配置评审时,钩子只注入普通提醒,作为上下文而非强制阻断。

使用方式:通过命令设置或替换目标(bro work goal <condition…>),不带条件时仅显示状态;可 pause/resume 暂停或恢复(恢复会重置轮次),clear 清除目标(别名 stop、off、reset、none、cancel);每个动词都支持 --json 以机器可读形式输出。选项 --session <id> 用于固定目标会话(默认取 BRO_SESSION_ID/DEVIN_SESSION_ID 等环境变量),--turns N 设置评估预算(默认 goal.maxTurns,25)。在无会话环境的裸 shell 中执行 bro work goal <condition> 会写入仓库种子,下一次在该仓库启动的会话会将其作为自身目标,从而把任务交给下一个 worker。在具备原生 /goal 的宿主(如 Claude Code)上可直接使用其原生 /goal,而 bro work goal 保留为可脚本化、跨宿主、可由 worker 生成的接口。

条件写法:应为一个可度量的结束状态 + 明确的检查方式 + 必须满足的约束,因为评审依据会话所呈现的内容来判断,所以应选择工具输出能够证明的条件。示例:'npm test exits 0 and git status is clean — or stop after 20 turns',或 'all threads on PR #412 resolved and bro review act status green'。

适用场景:需要让会话持续推进直至测试通过、状态干净或评审通过等可验证状态的任务;跨会话交接任务;需要脚本化控制目标状态的多宿主环境。

限制:判定依赖评审配置与会话呈现的证据;未配置评审时仅有提醒,不强制阻断;轮次预算耗尽会暂停目标,需要手动恢复;其余平台兼容性与收费信息暂未提供。