智能体协作指令语法规范 v1.1

适用范围:AI-Council-Workbench 协商面板输入框
设计定位:全能力轻量编排指令集,以极简符号体系覆盖「角色指派、资源挂载、动态创生、多轮协商、博弈裁决、流程编排」全场景,坚持硬解析零歧义、梯度渐进式、临时生效三大核心原则,对标「智能体协作的 Markdown」。

一、总则

1.1 核心设计原则

  1. 代码级硬解析:所有语法符号均为字符串正则解析,不依赖大模型语义理解,执行逻辑 100% 可预期,无模糊地带。
  2. 梯度能力解锁:从基础单次提问到多轮博弈收敛,用户按需使用对应语法,无强制学习负担,新手零门槛、高手可精细化控参。
  3. 临时生效隔离:所有动态创建、属性挂载、规则配置仅对当前任务链路生效,不修改全局角色库、不污染系统配置,用完即散。
  4. 输入即拓扑:无需拖拽画布、无需配置表单,纯文本输入同步完成角色定义、资源分配、流程编排、博弈规则设定,全程手不离开键盘。

1.2 语法符号总览

符号类别 符号 语法作用 作用域
角色基础 @ 角色指派 后跟角色唯一标识,硬路由至对应智能体
角色创生 () 动态创建临时智能体 @(名称:人设) 即时生成一次性角色,仅当前链路有效
资源挂载 [] 知识库挂载 强制注入指定知识库内容,输出基于知识库
{} 技能包挂载 临时启用工具/能力集,调用完成自动回收权限
<> 运行参数覆写 临时覆盖模型、温度、最大Token等参数
# 标签/历史线程引用 批量匹配资源,或引用指定历史协商线程内容
执行流控制 换行 串行阶段分隔 上一阶段全部执行完成,下一阶段才启动
同行空格 并行单次执行 同一行多角色同时启动,彼此上下文隔离,单次输出
>> 结果流向运算符 左侧所有产出作为上下文,输入给右侧角色
多轮交互 & 协商会议模式 多角色多轮协同讨论,可参考彼此发言
&& 交叉强博弈模式 多角色对立辩论,必须针对对方观点反驳质询
^N 最大轮次约束 协商/博弈的最大轮次数,到达后自动终止

1.3 解析优先级(从高到低)

  1. 按换行拆分全局串行阶段
  2. 每个阶段内按 >> 拆分流向链路
  3. 链路内按 & / && 拆分协商/博弈单元
  4. 单元内解析每个 @角色 及其挂载属性
  5. 最后解析任务描述文本与引用锚点

二、基础层:单次提问与基础编排

2.1 标准单次提问

语法格式@智能体[知识库]<参数>{技能包} 需求描述

  • 单个角色单次响应,支持叠加各类挂载属性
  • 作用域默认绑定光标所在文本块,上下文自动裁剪

示例

@架构师[公司技术规范]<temp=0.2,model=deepseek> 优化本段缓存设计

2.2 同行并行执行

同一行内多个 @角色 空格分隔,视为同一阶段并行执行,各角色独立计算、互不干扰,全部返回后阶段结束。
示例

@产品经理 做产品分析 @架构师 做架构评估 @风控 做风险评估

2.3 换行串行执行

每一行代表一个刚性执行阶段,上一阶段全部完成后,下一阶段启动,且天然继承上一阶段全部上下文。
示例

@架构师 输出初版方案

@工程师 评审落地可行性

2.4 结果流向运算符 >>

显式声明「左侧产出作为右侧角色的唯一输入」,语义强于普通换行的上下文继承,专门用于汇总、裁决、收敛场景。

  • 可跨阶段使用:行首 >>@角色 代表承接上一阶段全部结果
  • 可同阶段使用:协商/博弈后紧跟 >>@角色 代表自动收敛

跨阶段示例

@产品 @架构师 @风控 分别输出评审意见
>>@整合者 基于三方意见输出最终方案

三、进阶层:动态创生与上下文扩展

3.1 动态创建临时智能体

语法格式@(角色名:人设描述)

  • 即时生成一次性临时智能体,基于通用基础模板 + 人设描述生成系统提示词
  • 支持后续紧跟 [] {} <> 挂载属性,规则与永久角色完全一致
  • 仅当前任务链路内有效,执行完毕后自动销毁,可手动选择保存至全局角色库

示例

@(电商运营专家:精通天猫店铺运营与流量转化){数据分析} 给出618活动优化建议

3.2 历史对话引用

语法格式#线程名称>>锚点
将指定历史协商线程的内容注入当前上下文,只读引用,不修改原线程数据。支持两种锚点模式:

  1. 片段锚点#线程名>>某段回答标识,精准引用单条回复内容
  2. 角色锚点#线程名>>@角色名,引用该角色在对应线程中的全部发言

示例

@架构师 从 #v2方案评审>>@工程师 的回复里,提取性能瓶颈并给出优化方案

四、高级层:多轮协商与博弈机制

4.1 协商会议制 &

多角色围绕同一议题开展多轮协同讨论,角色可参考历史所有发言,逐步完善观点,适用于方案共创、头脑风暴场景。
语法格式@角色A & @角色B & @角色C ^N 讨论议题

  • & 连接所有参与协商的角色,角色数量无上限
  • ^N 指定最大讨论轮数,N 为正整数,每一轮所有角色各发言一次
  • 轮次间上下文完全继承,角色可基于前序发言补充、修正观点
  • 达到最大轮次或连续两轮无新增观点时自动终止

示例

@产品经理 & @架构师 & @技术负责人 ^3 讨论用户中心重构方案

4.2 交叉强博弈 &&

多角色对立立场辩论,强制要求每轮发言必须针对对方上一轮观点进行反驳、质疑或举证,禁止自说自话,适用于方案评审、风险论证、正反方辩论场景。
语法格式@角色A && @角色B ^N 辩论议题

  • && 代表强博弈关系,系统强制注入对立立场提示词
  • ^N 指定最大辩论轮数,通常为 3~5 轮
  • 每轮交替发言,后发言者必须回应前发言者的核心论点
  • 全程保留完整辩论链路,便于后续裁决

示例

@技术乐观派 && @风险保守派 ^3 论证微服务拆分的必要性

4.3 博弈收敛机制

协商或博弈结束后,通过 >> 流向指定角色进行最终裁决、汇总或定调,自动形成「讨论/辩论 → 收敛裁决」的完整闭环。
语法格式协商/博弈单元 ^N >> @裁决角色 议题

  • 协商模式 + 收敛:用于多角色讨论后统一汇总输出
  • 博弈模式 + 收敛:用于正反辩论后由第三方出具最终裁决

协商收敛示例

@产品 & @研发 & @运维 ^3 讨论上线方案 >> @项目总监 敲定最终排期

博弈裁决示例

@方案A支持者 && @方案B支持者 ^3 辩论技术选型 >> @架构师 出具最终选型结论

五、完整场景演示

5.1 方案多角色评审与落地

对应「并行评审 → 汇总整合 → 拆解落地 → 工程输出」全链路

@产品经理 请对方案进行产品分析。@架构师 请对方案进行架构评估。@风险评估 请对方案进行风险评估。
>>@方案整合师 请整合三方意见,输出统一方案
@项目经理 针对整合方案制定详细落地计划
@架构师 基于落地计划输出工程落地方案,要求简洁可执行

5.2 全栈项目自动化落地

对应「设计 → 部署 → 开发 → 前端 → 测试」流水线,技能包随任务挂载,全程闭环

@PHP工程师 请设计用户中心对应的数据库表结构
@运维工程师{MySQL操作} 请把表结构写入user数据库
@PHP工程师{文件操作} 请开发业务后端代码,输出标准REST接口
@前端工程师{文件操作} 根据接口完成Vue前端页面开发,完成后启动工程并返回访问URL
@测试工程师{浏览器操作} 请根据URL进行全功能测试,输出正式测试报告

5.3 正反博弈论证决策

对应「正反辩论 → 专家裁决 → 输出结论」决策流程

@自研派 && @采购派 ^3 辩论用户中心自研vs采购的优劣
>>@CTO 基于辩论结果给出最终决策与理由

六、前端交互辅助规范

为降低语法记忆成本,前端配套四类实时辅助能力,全程不打断输入节奏:

  1. 智能联想补全
    • 输入 @ 弹出角色列表,输入 ( 自动提示临时创生语法模板
    • 输入 [ { < 对应弹出知识库、技能包、参数候选列表
    • 输入 & && ^ >> 自动提示语法说明与示例
  2. 语法实时校验
    • 不存在的角色、知识库、技能包实时标红,悬浮提示错误原因
    • 括号不闭合、符号格式错误实时标注,不阻塞输入
  3. 执行状态可视化
    • 并行任务:多个角色同步显示加载动画
    • 协商/博弈:显示当前轮次、总轮次,高亮当前发言角色
    • 流水线:阶段式进度条,清晰展示当前执行节点
  4. 结果一键复用
    • 临时创建的优秀智能体,可一键保存至全局角色库
    • 完整指令流可一键保存为「拓扑模板」,后续一键复用

七、边界与适用范围

7.1 强适用场景

  • 单文档内即兴多角色评审、分段润色、局部优化
  • 3~10个节点的轻量项目流水线,快速验证落地
  • 临时专题讨论、正反博弈论证,辅助决策
  • 一次性定制角色需求,无需修改全局配置
  • 日常文档打磨、代码重构、方案研讨等高频场景

7.2 非适用场景

  • 跨项目、跨周期的长周期复杂任务管理
  • 包含异常重试、分支判断、容错策略的重度生产级工作流
  • 需要精细配置预算、权限、超时、熔断规则的矩阵级任务
    以上场景仍使用标准业务拓扑配置(YAML),保证管控粒度与稳定性。

7.3 与拓扑配置双向互通

  • 输入框编写的指令流,可一键导出为标准 YAML 拓扑模板,纳入矩阵配置库
  • 已有的复杂拓扑模板,可一键导入为指令文本,在输入框内快速微调执行
  • 轻量场景用指令即兴执行,重度场景用配置固化运行,形成完整互补

八、AAM 矩阵架构映射

本语法体系与自治智能体矩阵架构天然同构,Phase 4 对接时可无损转换为矩阵标准机制:

  1. 动态创生 → 构造者临时实例化@(人设) 对应矩阵构造者智能体基于标准模板生成临时执行体,任务结束自动回收,符合「按需分化」原则。
  2. 结果流向 → DAG 依赖边>> 运算符对应拓扑中的节点依赖关系,自动生成标准 DAG 结构。
  3. 协商/博弈 → 治理仲裁机制& 协同对应多角色会商流程,&& 博弈对应仲裁院庭辩流程,>> 收敛对应最终裁决环节。
  4. 轮次约束 → 预算与生命周期控制^N 轮次对应任务的预算分段释放机制,轮次耗尽自动终止,避免无意义消耗。
  5. 历史引用 → 知识引擎检索#线程>>锚点 对应矩阵知识引擎的历史任务检索与片段复用能力。
  6. 人工裁决 → 验收层门禁:所有输出均为建议态,最终采纳权在人类,与矩阵验收层质量门禁完全对齐。

版本:v1.1 | 适用阶段:Phase 1 ~ Phase 3 | 兼容矩阵版本:AAM v1.0

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐