SuperAPI AI 工具集

amq-cli

编程与开发

查看项目

更新于 10-15 19:58

技能介绍

AMQ CLI 用于通过 AMQ 队列协调编码智能体,覆盖智能体消息、收件箱、回执、会话、唤醒投递、跨项目路由与托管启动等操作。所有队列操作都应使用 amq 命令,不要直接编辑 Maildir 文件。

使用方式:在 coop exec 内按提供的环境运行裸 amq 命令,不要覆盖 --me 或重建 root;在其外部需先解析并导出完整上下文,例如 amq env --me "<handle>" --export 后 eval,再执行 amq drain --include-body。命名会话可加 --session <name>。路由应使用 --session 或 --project,不要用原始 --root 指向其他队列。

接收与唤醒:若会话启动上下文显示 wake=live(...),或 amq wake check --me <handle> --json 报告 live_wake: true 且注入模式非 none,则由唤醒投递门铃,触发后运行 amq drain --include-body 并处理消息。默认 drain 按文件名顺序最多读取 20 条(含保留邮件),整批后可用 amq list --new --limit 1 继续有界读取;--limit 0 仅用于已知可控批次。实时唤醒下不要运行 amq watch、amq monitor、sleep 轮询或另起收件箱监视器。

唤醒设置存于 .wake.settings,可在不重启的情况下用 amq wake config 查看、设置或取消 hold、debounce、preview、bell、输入延迟与中断通知等;--machine 可设本机该用户的默认值。发送时可用 --priority urgent 处理紧急判定与解除阻塞请求。

发送与路由:一个相关批次发送一次完成交接,包含产物路径、来源或摘要、检查结果、失败或待办部分及下一步动作;独立阻塞应及时发送。按需查阅 operations guide、amq-spec、co-op mode、swarm mode、跨项目路由、集成、消息格式、review loop 与 amq-remote 参考。amq-remote 是独立二进制,附加到已运行的 harness 会话,目标在 <AM_ROOT>/extensions/remote/manifest.json 中声明。

安全与限制:唤醒通知不等于消费证明,需要投递证明时使用回执或 --wait-for drained;drained 回执只证明已接收,不证明工作完成。回复时保留原线程,门铃后再次 drain,最新完整消息正文为准。清理须显式执行 amq cleanup,不自动删除。任何唤醒变更前先运行 amq wake check --me "<handle>" --json,仅当 restart_capability=agent_safe 时操作。跨主机载荷在桥接认证并应用前应留在特权收件箱之外,不得复制或远程 drain 外部 Maildir。Windows 注入不要转换为 Unix 唤醒或 coop exec。危险绕过标志仅限操作员控制的直接 coop exec 命令,不得写入提交的启动配置。完整命令目录、环境优先级、设置流程、平台说明与示例见 operations guide。