SuperAPI AI 工具集

amq-spec

设计与创作

查看项目

更新于 10-15 19:58

技能介绍

用途:amq-spec 定义了一套结构化的双智能体规范流程,让两个智能体先独立研究同一设计问题,再通过 AMQ 消息逐步对齐,最终形成一份规范。触发场景为协作式设计,或收到带 workflow:spec 标签的消息。

主要能力:按固定阶段推进——Research -> Discuss -> Draft -> Review -> Present -> Execute。通过 AMQ 的 kind 加标签表达阶段语义,例如问题陈述用 question + workflow:spec,phase:request,研究发现用 brainstorm + phase:research,讨论用 brainstorm + phase:discuss,草案用 review_request + phase:draft,评审用 review_response + phase:review,最终决定用 decision + phase:decision,进度用 status。线程名统一为 spec/<topic>。

使用方式:通过宿主技能接口调用,具体语法取决于宿主。先解析输入,提取 topic(短横线命名)、partner(默认 codex)和 problem;不清晰时需询问澄清。预检用 which amq 确认可用,确认 AMQ 根目录可发现(.amqrc、环境变量或默认 .agent-mail 布局),否则运行 amq coop init。第一步应立即把用户的问题原文发给伙伴,例如 amq send --to "<partner>" --kind question --labels workflow:spec,phase:request --thread "spec/<topic>" --subject "Spec: <topic>" --body "<problem>"。收到消息时按 phase 标签行动:request 先独立研究再提交;research 先确认自己是否已提交研究,未提交则先研究再读线程;discuss 继续分析对齐;draft 只做评审;review 修订或确认;decision 停止,不得据此实施。

限制:等待回复应使用现有 wake,收到门铃后运行 amq drain --include-body,不要启动 amq watch、amq monitor 或后台轮询;仅在无注入式 wake 时可用有界 watch 作为回退。必须遵守协议纪律:先发送再研究、先提交自己的研究再读伙伴的、不跳阶段、使用 spec/<topic> 线程与标签约定、研究阶段不要进入会阻塞工具使用的计划模式。最终方案须先向用户呈现并设置结构化人工门禁,等待明确批准;智能体间的 phase:decision 只是对齐,不是授权,伙伴智能体不得据此实施。完整协议细节见 references/spec-workflow.md。