SuperAPI AI 工具集

ask-user

通用与其它

查看项目

更新于 10-16 05:48

技能介绍

用途:ask-user 是一个可复用的交互模式,用于在智能体执行过程中设置决策点,向用户展示明确选项并暂停当前回合,等待用户回应后再继续。它被 cold-start、ingest、enrich、brain-ops、meeting-ingestion、archive-crawler 等技能引用,用于需要用户确认或选择的分支。

主要能力:展示 2-4 个选项(超过 4 个会造成决策瘫痪);每个选项标签采用“动作动词 + 简短限定语”,避免“选项 1”这类模糊表述;必须包含退出选项(Skip、Cancel 或“以上都不是”);每条消息只问一个问题,不叠加多个选择门;展示后立即停止回合,不进行后续工具调用、不预执行、不默认继续。

使用方式:平台无关格式为带编号或标签的选项列表,可配合 Telegram、Discord、Slack 的内联按钮,或 OpenClaw 智能体的 clarify 工具。用户回应后,读取按钮点击、编号或文本,简短确认,再分支执行;若回应不明确则再次询问。文本回应可做模糊匹配,如“第一个”“A”“1”映射到第一项,“merge”匹配对应标签;无关消息则放弃该选择门。

适用场景:模糊请求有多种合理解释、破坏性操作(批量删除、覆盖)、归档或路由决策、优先级排序、冷启动阶段门、错误默认会造成大量返工的岔路。不适用:指令清晰明确、低风险决策、延迟成本高于错误选择、用户已表达偏好。

限制与失败处理:gbrain 调用退出码 3(confirmation_required)或 fix.next 为 ask_user 时,应原样转达 [SHOW USER] 块或 user_message 作为选项,然后停止等待;用户回答“否”或未回答时,报告该步骤已跳过,不得代为传入 --yes 或 --max-usd。反模式包括:展示选项后继续回合、静默选择默认值、超过 4 个选项、缺少退出选项、一条消息叠加多个选择门、标签晦涩、对低风险决策提问。输出格式为 emoji 前缀的问题行、1-3 行上下文、带标签的选项列表,发出后停止回合,等待用户回应触发下一回合。