Brief

第一个用于显式 Agent 委派的开放协议

将混乱的多 Agent 移交过程转化为结构化、可审计的任务简报。

English | 中文

---

为什么需要 Brief

目前的 AI Agent 生态系统已经为工具调用 (MCP)、Agent 发现与传输 (A2A) 以及 Agent 能力 (Agent Skills) 建立了标准。然而，最关键的交互环节——一个 Agent 如何正式地将任务委派给另一个 Agent——仍然缺乏标准。

Cognition 团队（Devin 的创建者）在他们极具影响力的文章 《别去构建多 Agent 系统》 中指出了这一缺口，并将其称为**“隐式移交” (Implicit Handoff)** 问题：Agent 在没有结构化上下文的情况下传递任务，导致决策冲突、上下文丢失以及系统脆弱。他们的诊断非常精准，但我们认为答案并非放弃多 Agent 架构，而是将委派本身形式化。

Brief 是首个致力于解决此问题的开放协议。 它引入了一种标准化的、人类可读的 Agent 间任务委派格式，填补了* Agent 如何通信* (A2A) 与 Agent 能做什么 (MCP/Skills) 之间缺失的语义层。

工作原理

整个协议由两个 Markdown 文件组成：

Agent A: 发送 brief-001.brief.md
  "这是我明确需要的任务、原因以及我期望的返回结果。"

Agent B: 发送 brief-001.response.md
  "这是我所做的工作以及我提交的成果。"

就是这样。没有新的 DSL，没有二进制格式，也没有框架锁定。只要你会写 Markdown，就能使用 Brief。

生态位

Brief 并不是另一个框架，而是一个语义层，旨在补充而非替代现有标准：

┌─────────────────────────────────────────────────┐
│                  您的应用程序                    │
├─────────────────────────────────────────────────┤
│  Brief 协议      (.brief.md / .response.md)     │  ← 做什么
├─────────────────────────────────────────────────┤
│  A2A 协议        (传输与发现)                    │  ← 如何查找与对话
├─────────────────────────────────────────────────┤
│  MCP 协议        (工具调用)                      │  ← 如何使用工具
├─────────────────────────────────────────────────┤
│  Agent Skills    (SKILL.md)                     │  ← Agent 知道什么
└─────────────────────────────────────────────────┘

为什么选择 Brief？

特性	Brief	特设 (Ad-hoc) 多 Agent	单体 (Monolithic) Agent
上下文隔离	显式契约	共享内存（易污染）	不适用
可审计性	完整跟踪日志	黑盒	单一日志
级联 (A→B→C→D)	内置深度控制	手动连接	不可能实现
分发 (A→B∥C)	原生支持	复杂的编排	不可能实现
学习曲线	编写 Markdown	学习框架 API	不适用
生态契合度	补充 MCP + A2A	替换所有内容	不适用

快速开始

安装

npm install brief-sdk
# 或
pnpm add brief-sdk

创建简报 (委派方)

import { Brief } from 'brief-sdk';

const brief = Brief.create({
  delegator: 'agent-orchestrator',
  delegatee: 'agent-code-reviewer',
  body: `# Briefing: Review PR #42

## Objective
Review the OAuth 2.0 migration code for security issues.

## Key Constraints
- Focus on token handling and storage.
- Check for N+1 queries.

## Expected Deliverables
1. Review summary with findings.
2. Approve or reject recommendation.`,
});

// brief.content 是一个合法的 .brief.md 字符串 — 可以通过任何方式发送
console.log(brief.content);

接收并响应 (被委派方)

import { Brief } from 'brief-sdk';

const incoming = Brief.parse(receivedMarkdown);

console.log(incoming.delegator);  // "agent-orchestrator"
console.log(incoming.isSubBrief); // false

// 执行任务...
const results = await myAgent.review(incoming.body);

// 创建结构化响应
const response = incoming.createResponse({
  status: 'success',
  body: `# Review Complete

## Findings
- Approved with minor suggestions.
- Found unused import in auth/handler.ts.

## Recommendation
**Approve** — merge after addressing minor issues.`,
});

// response.content 是一个合法的 .response.md 字符串

级联委派 (A → B → C)

const parentBrief = Brief.parse(receivedMarkdown);

// 创建子简报 — parentId 和 depth 会自动设置