SuperAPI AI 工具集

messaging-the-human

通用与其它

查看项目

更新于 10-16 01:32

技能介绍

用途:当项目策略要求人类决策或更新、有待处理或失败的投递、或需要让回复续接正确工作时使用。本技能只提供与传输方式无关的机制;安装它不会创建审批门,也不选择连接器。若策略对某个实质决策含糊,应指出缺失的授权,不要把一个可解决的技术故障转成人类门。

发现与检查:使用 rig gateway human list --json 和 rig gateway human show <entityId> --json 查询已注册参与者并检查选定的人类,使用返回的 <entityId>@external 地址,而非用户名、记忆座位、连接器句柄或猜测的内核地址;登记缺失或含糊需要点名修正登记,不能用回退地址。检查 readiness 的 configured、enabled、active、ready、reason 与 next action;indeterminate 不算就绪,按报告的下一步检查,不要为使检查通过而启用或重配连接器。

撰写与发送:为手机阅读者写作,用 --summary 写短主题,用 --body-file 写一份完整简报:为何重要、你的建议与重大取舍、获准后的有限动作、所请求的选择;更新则说明用户可见结果与“No action needed”。目标约 100–150 词,仅为指导而非语义校验。技术续接、候选/修订与证据应留在归属智能体行及 --evidence-ref 指向的持久产物中;本地路径不是手机链接,Markdown 证据文件不会自动附带。发送原语为 rig queue create --destination <entityId>@external --human-intent decision --summary "<short subject>" --body-file <brief-file> --evidence-ref <durable-evidence> --verify --json;可用 --human-detail-file 在同一线程补充一致回复。

回复与阻塞:关于先前工作的后续更新可用 --reply-to <earlier-qitem-id>,仅接受 --human-intent update,须在同一主机、由拥有该线程的座位发出,否则会作为新消息。回复人类回复时,--reply-to 其回复所在行。决策可用 --human-questions-file 提供 1–4 个问题,每题 2–4 个选项,最多一个推荐项。行在有限投递核验前持久化;posted 只证明连接器投递,不证明人类已读。transport-failed、never-posted 或 pending/indeterminate 结果保留该行,应检查同一行及其下一步,不要因超时另建行或盲目重发。人类决策行会恢复其依赖者;不要把该行同时阻塞在人类地址上,以免重复通知。rig send 仅到达智能体终端,不是人类传输。其余连接器配置属于注册表/就绪工具。其他事实暂未提供。