用途:spec 定义了一套结构化的双智能体协作规格流程,用于让两个智能体共同完成设计问题的规格制定。触发词包括 spec、design with、collaborative spec、spec with codex、spec with claude 等。
主要能力:按固定阶段推进——Research(研究)→ Discuss(讨论)→ Draft(起草)→ Review(评审)→ Present(呈现)→ Execute(执行)。通过 AMQ 消息传递,用 kind 加 labels 表达各阶段语义,例如问题陈述用 question + workflow:spec,phase:request,研究发现用 brainstorm + phase:research,计划草案用 review_request + phase:draft,评审反馈用 review_response + phase:review,最终决定用 decision + phase:decision。所有消息统一使用线程名 spec/<topic>。
使用方式:先解析用户输入,提取 topic(kebab-case 规格名)、partner(默认 codex)和 problem(完整设计问题陈述),不清晰时需询问澄清。预检需确认 AMQ 可用(which amq)并初始化协作(.amqrc,否则运行 amq coop init)。关键规则是第一步立即把用户问题原文发送给伙伴,不做任何预先研究,例如:amq send --to <partner> --kind question --labels workflow:spec,phase:request --thread spec/<topic> --subject "Spec: <topic>" --body "<problem>"。收到 spec 消息时按 phase 标签执行对应动作。
适用场景:需要两个智能体并行研究、讨论并评审同一设计问题的规格协作。
限制:伙伴智能体永不实现代码,只有发起者向用户呈现计划;必须等用户明确批准后才能开始实现;不得跳过阶段、不得在提交自身研究前阅读伙伴研究、不得在用户批准前实现。完整协议细节见 references/spec-workflow.md。