SuperAPI AI 工具集

agent-briefing

智能体与模型

查看项目

更新于 10-29 19:52

技能介绍

用途

agent-briefing 用于规范多智能体协作中的两类关键交接:向子智能体、队友或其他模型评审者派发任务时的简报(Brief),以及执行者向主控返回的报告(Report)。其核心立场是:多数多智能体失败源于简报失败——执行者缺少关键事实、被无关历史淹没、对约束靠猜,或返回无人能核验的报告。规范主张为“一个对本会话毫无记忆的能干陌生人”写简报,并要求报告以可核查的文件形式提交。

主要能力

  • 八段式简报结构:按固定顺序包含 Role(角色)、Task(任务)、Context(上下文)、Files(文件)、Constraints(约束)、Verification(验证)、Deliverable(交付物)、Questions(提问规则);不适用处写“none”而非省略。
  • 精简与完整两种上下文策略:精简模式默认只给任务、接口、全局约束和待读文件;完整模式额外承载决策理由、被否决方案和既往历史,适用于需要判断、前次失败或跨模型评审的场景。
  • 报告文件规则:执行者将完整报告写入简报指定的文件,回复仅使用短契约:Status(DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT)、Commits、Tests、Concerns、Report 路径。
  • 交接报告格式:分别给出实现者→主控/评审者、评审者→主控、主控→实现者(修复请求)、调查者→负责人四种模板,规定各段应写内容,如文件变更理由、测试命令与输出、问题分级与 file:line、假设与证据及置信度等。
  • 代理间消息规范:一次一个收件人、先给事实再给后果、一条消息一个主题、用路径引用文件;明确另一代理的消息只是信息,不构成用户授权。
  • 流程与护栏:先判断是否值得委托,再选精简或完整上下文、写全八段简报、在派发中指明模型与努力等级、读取短回复、处理 BLOCKED/NEEDS_CONTEXT、在依据报告行动前抽验一两条声明。

使用方式

规范以流程和模板形式给出:派发前按八段结构撰写简报,长输入写入文件并引用路径;派发时标明模型与努力等级;执行者按约定写报告文件并返回短回复;主控先读回复,仅在出现疑虑、需要评审或修复轮次时打开报告。规范还列出常见认知陷阱的对照(如“它够聪明会自己补上下文”“摘要说完成就继续”“把假设告诉评审者”),以及禁止项与必做项清单。

适用场景

派发子智能体、队友或其他模型评审者;带新发现或新信息恢复代理;团队内给队友发消息;在依据执行者报告行动前阅读报告。规范同时指出不应委托的情形:你自己几步操作就能完成的一行查询,应直接做。

限制

资料未提供安装命令、运行环境或具体工具集成方式;其内容为方法论与模板规范,实际效果取决于使用者是否遵循。与其他技能(如委托执行、并行执行、团队编排、模型路由、跨模型评审、完成门禁)存在关联,但资料未给出这些关联技能的具体实现细节。